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这 一 本 学 做 结合 的 指南 ， 旨 在 教 你 使 用 Django 和 Python 做 Web 开发 。 本 书 主要 针对 学 生 ， 因 此 
会 详解 使 用 Django 开发 Web 应 用 过 程 中 的 每 个 步骤 。 


Django 官方 提供 了 一 份 教程 ， 而 且 网 上 也 有 很 多 优秀 的 教程 ， 本 书 的 目标 是 填补 一 些 空 白 ， 通 过 
实例 开发 学 习 Django 框架 。 此 外 ， 本 书 还 会 介绍 开发 Web 应 用 所 需 掌 握 的 其 他 知识 ， 例 如 
HTML, CSS, JavaScript 等 等 。 


1.1 本 书 特色 


mE 事半功倍 

笔者 见 过 很 多 聪明 的 学 生 陷入 伪 局 ， 浪 费 几 小 时 的 时 间 和 尝试 解 决 直到 的 Django 或 其 他 Web 开发 
问题 。 这 些 问题 往往 是 由 于 抓 不 住 重点 ， 或 者 所 用 的 材料 言语 不 详 。 有 时 ， 你 可 能 灵光 一 现 ， 在 
十 几 分 钟 之 内 解决 问题 ， 但 是 更 多 的 时 候 要 耗费 几 小 时 。 笔 者 结合 自己 的 经 验 ， 力 求 消除 这 些 障 
碍 ， 让 你 远离 坎坷 ， 在 开发 应 用 的 过 程 中 一 帆 风 顺 。 


口 平缓 学 习 曲 线 
Web 应 用 框架 省 时 省 力 ， 但 前 提 是 你 知道 怎么 使 用 框架 。 框 架 的 学 习 曲 线 往往 陡峭 。 本 书 力求 平 
缓 学 习 曙 线 ， 详 解 方方面面 ， 让 你 快速 掌握 框架 的 用 法 。 


口 改进 工作 流程 

使 用 Web 应 用 框架 要 遵守 特定 的 设计 模式 ， 你 只 需 在 特定 的 位 置 放置 特定 的 代码 。 但 是 ， 与 很 多 
学 生 交 流 之 后 ， 笔 者 发 现 他 们 经 常 抱 忽 ， 不 知 如 何 从 框架 那里 夺回 控制 权 ( 即 控制 反 转 ) 。 为 
此 ， 笔 者 制定 了 几 个 工作 流程 ， 帮 你 在 开发 过 程 中 重 获 控 制 权 ， 以 自己 的 方式 构建 Web 应 用 。 


吕 边 学 边 做 
无 论 如 何 ， 不 要 只 是 看 看 内 容 而 已 。 这 是 一 本 实 作 指南 ， 你 要 自己 动手 使 用 Django 构建 Web 应 
用 。 动 眼 不 动手 可 不 行 ! 奉 想 有 所 获 益 ， 请 跟着 本 书 一 起 开发 应 用 。 而 且 ， 在 开发 的 过 程 中 ,不 


要 复制 粘贴 书 中 的 代码 。 自 己 动手 输入 ， 想 想 代 码 的 作用 ， 然 后 再 阅读 书 中 给 出 的 说 明 。 如 果 依 
旧 不 解 ， 查 阅 Django 文档 ， 到 Stack Overflow 或 其 他 网 站 中 寻求 帮助 ， 一 定 要 把 不 理解 的 地 方 弄 
明白 。 如 果 你 确实 陷 人 僵局 了 ， 可 以 联系 笔者 ， 以 便 笔 者 改进 内 容 一 一 已 经 有 多 位 读者 为 本 书 做 
出 了 贡献 。 


1.2 你 将 学 到 


本 书 以 一 个 示例 为 主线 ， 说 明 如 何 开发 一 个 名 为 Rango 的 Web 应 用 。 在 这 个 过 程 中 将 讲解 如 何 完 
成 下 述 关 键 任务 : 

搭建 开发 环境 ， 包 含 学 习 使 用 终端 、 虚 拟 环境 、pip 安装 程序 和 Git， 等 等 。 

创建 Django 项 目 和 简单 的 Django 应 用 。 

配置 Django 项 目 ， 伺 服 静 态 媒 体 和 其 他 媒体 文件 。 

使 用 Django 的 “模型 -视图 -模板 ”设计 模式 。 

创建 数据 库 模 型 ， 使 用 Django 提供 的 对 象 关系 映射 (Object Relational Mapping, ORM) 
功能 。 

创建 表单 ， 利 用 数据 库 模 型 生成 动态 网 页 。 

使 用 Django 提供 的 用 户 身份 验证 服务 。 

在 Django 应 用 中 融合 外 部 服务 。 

在 Web 应 用 中 引入 层 局 样式 表 (Cascading Styling Sheet, CSS) 和 JavaScript, 

使 用 CSS 为 应 用 提供 专业 的 外 观 。 

在 Django 应 用 中 处 理 cookie 和 会 话 。 

在 应 用 中 使 用 Ajax 等 高 级 技术 。 

把 应 用 部 署 到 PythonAnywhere 上 。 


U U U O 已 


oo oO Ue LC U U U 


该 


每 一 章 结尾 都 有 几 道 练习 题 ， 旨 在 加 强 你 对 知识 的 掌握 ， 也 检验 你 能 不 能 学 以 臻 用。 后面 几 章 
有 开放 性 开发 练习 ， 而 且 提 供 了 参考 代码 和 说 明 。 


</> 这 样 的 区 域 是 练习 


每 一 章 都 有 练习 题 ， 旨 在 检查 你 对 知识 和 技能 的 掌握 情况 。 你 必须 解答 这 些 练习 ， 因 为 后 面 
的 章节 建立 在 这 些 题目 之 上 。 


别 担 心 自己 做 不 出 来 ， 本 书 的 GitHub 仓库 中 有 所 有 练习 题 的 解答 。 


1.3 用 到 的 技术 和 服务 


本 书 将 使 用 的 技术 和 外 部 服务 如 下 : 


I Python 编程 语言 D CSS 

d pip 包 管 理 器 D JavaScript 编程 语言 

LI Django 框架 D jQuery Æ 

J Git 版 本 控制 器 系统 口 Twitter Bootstrap 框架 

J GitHub L Webhose API〈 即 后 文 所 用 的 搜索 API) 
d HTML d PythonAnywhere 托管 服务 


LE ROR AIRS EAE ATE, FP LEE Web 开发 的 基础 。Twitter Bootstrap 为 Web 应 用 提供 
样式 ，Webhose API 是 一 个 外 部 服务 ，PythonAnywhere 则 能 简化 部 署 应 用 的 过 程 。 


1.4 Rango 的 初步 设计 和 客户 要 求 


本 书 的 主线 是 开发 一 个 名 为 Rango 的 应 用 。 在 这 个 过 程 中 ,我们 将 涵盖 构建 Web 应 用 所 需 掌 握 的 
重要 知识 。 如 果 想 查看 这 个 应 用 的 最 终 版 本 ， 请 访问 hitp://rangodemo pythonanywhere.com/ran- 
gol, 


设计 概要 


客户 要 求 你 开发 一 个 名 为 Rango 的 网 站 ,让 用 户 按 分 类 浏览 不 同 的 网 页 。 在 西班牙 语 中 ，“rango” 
的 意思 是 “等 级 "或 “显要 地 位 ”。 


DJ 用 户 访问 Rango 网 站 的 首页 时 ， 客 户 想 让 访客 看 到 : 
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”访问 次 数 最 多 的 5 个 网 页 
”查看 次 数 最 多 的 5 个 分 类 
”浏览 或 搜索 分 类 的 不 同方 式 


口 用 户 访问 分 类 页 面 时 ， 客 户 想 让 Rango 显示 : 


”分 类 的 名 称 、 查 看 次 数 、 点 赞 次 数 ， 以 及 分 类 下 的 网 页 (显示 网 页 的 标题 ， 并 链接 到 网 
页 的 URL) 


”一 定 的 搜索 功能 (通过 搜索 API 实现 ) ， 找 出 可 以 归 人 当前 分 类 的 网 页 


J 客户 要 求 记录 分 类 的 名 称 ， 分 类 页 面 被 查看 的 次 数 ， 以 及 多 少 用 户 点 击 了 “点 赞 "按钮 ( 即 
用 户 对 分 类 打分 ， 投 票 排名 ) 。 


J 各 分 类 能 通过 友好 的 URL 访问 ， 例 如 /rango/books-about-django/ , 
J 只 有 注册 用 户 能 搜索 ， 能 把 网 页 添加 到 分 类 中 。 因 此 要 让 网 站 的 访客 能 注册 账户 。 


Rat 


这 么 一 看 ， 我 们 要 开发 的 应 用 并 不 复杂 ， 不 过 是 列 出 一 些 网 页 的 分 类 而 已 。 然 而 ， 这 其 中 有 些 
杂 问 题 需要 解决 ， 可 能 并 不 像 想 的 那样 简单 。 着 手 开 发 之 前 ， 我 们 先 规划 一 下 整体 设计 。 


</> 练习 
继续 阅读 之 前 ， 请 根据 客户 要 求 绘制 下 述 设计 图 ， 


N 层 或 系统 架构 图 

主页 和 分 类 页 面 的 线 框图 

应 用 的 URL 映射 

实体 关系 图 (Entity-Relationship diagram, ER 图 ) ， 描 述 要 实现 的 数据 模式 


G G ee 


在 继续 阅读 之 前 ， 请 试 着 完成 这 几 题 。 即 使 你 不 熟悉 系统 架构 图 、 线 框图 或 ER 图 也 没 关 
系 ， 这 几 题 的 重点 是 让 你 思考 如 何 说 明和 描述 即将 构建 的 应 用 。 


N 层 架 构 


多 数 Web 应 用 的 整体 架构 是 一 种 3 层 结构 。Rango 也 采用 这 种 架构 ， 不 过 稍 有 不 同 ， 因 为 它 还 要 


与 外 部 服务 交互 。 


图 1-1: Rango 的 3 层 系 统 架 构 


因为 我 们 将 使 用 Django 构建 这 个 Web 应 用 ， 所 以 各 层 用 到 的 技术 如 下 : 


J Pind Web 浏览 器 (例如 Chrome、Firefox 或 Safari) ,负责 演 染 HTML/CSS 页 面 。 
J 中 间 件 是 一 个 Django 应 用 程序 ， 在 开发 过 程 中 由 Django 内 置 的 开发 Web 服务 器 负责 调 
度 。 

1 数据 库 使 用 基于 Python 的 SQLite3 数据 库 引 擎 。 

_) 搜索 API 使 用 Webhose API, 


本 书 基本 上 将 集中 精力 开发 中 间 件 ， 不 过 从 图 1-1 中 不 难看 出 ， 我 们 也 将 与 其 他 组 件 交 互 。 


线 框图 


线 框图 可 以 让 客户 一 览 最 终 完成 的 应 用 是 什么 样子 。 线 框图 能 节省 大 量 时 间 ， 不 过 具体 形式 各 种 
各 样 ， 有 手绘 的 ， 也 有 使 用 专用 工具 的 。Rango 应 用 首页 的 设计 稿 见 图 1-2， 分 类 页 面 的 设计 稿 见 
图 1-3。 
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Ready to Rango 


Top Five Categories Top Five Pages 


图 1-2: 首页 ， 左 边 是 分 类 搜索 框 ， 右 边 是 查看 次 数 最 多 的 5 个 分 类 和 5 个 网 页 


页 面 和 URL 映射 


从 客户 的 要 求 中 我 们 知道 ， 应 用 至 少 要 有 两 个 页 面 。 为 了 能 访问 各 个 页 面 ， 我 们 要 描述 URL 映 
射 。 你 可 以 把 URL 映射 理解 为 访问 页 面 时 在 浏览 器 地 址 栏 中 输入 的 文本 。Rango 应 用 的 基本 
URL 映射 如 下 : 


d / 3 /rango/ 指向 主页 
J /rango/about/ 指向 关于 页 面 


1 /rango/category/<category_name>/ 指向 名 为 <category_name> (例如 games, python-recipes 
或 code-and-compilers) 的 分 类 页 面 


只 是 开始 ， 在 构建 应 用 的 过 程 中 ， 可 能 还 要 添加 其 他 URL 映射 。 本 书 将 带领 你 使 用 Django HE 
和 “模型 -视图 -模板 ”设计 模式 逐渐 丰富 这 些 页 面 的 内 容 。 对 URL 映射 和 页 面 的 设计 有 了 大 致 了 
解 之 后 ， 我 们 要 定义 数据 模型 ， 存 储 应 用 将 用 到 的 数据 。 


这 
Ha 


aon 


1. Python Programming Language - Official Website 


VV 一 


图 1-3: 分 类 页 面 ， 显 示 分 类 中 的 网 页 〈 带 有 访问 次 数 ) ， 以 及 搜索 "Python 得 到 的 结果 


实体 关系 图 


根据 客户 的 要 求 ， 很 明显 我 们 至 少 需要 两 个 实体 : 分 类 (category) 和 网 页 (page) 。 而 且 ， 一 个 
分 类 中 可 以 有 多 个 网 页 。 这 个 简单 的 数据 模型 可 以 通过 下 述 ER 图 描述 。 


注意 ， 这 个 关系 并 不 十 分 明确 。 理 论 上 ， 一 个 网 页 可 以 归 人 多 个 分 类 。 鉴 于 此 ， 分 类 和 网 页 之 间 
可 以 通过 多 对 多 关系 建 模 。 但 是 这 样 处 理 太 过 复杂 ， 因 此 我 们 将 假定 一 个 分 类 中 有 多 个 网 页 ， 而 
一 个 网 页 只 能 属于 一 个 分 类 。 这 样 并 不 妨碍 把 一 个 网 页 归 和 人 不 同 的 分 类 ， 只 不 过 要 多 次 输入 相同 
的 网 页 ， 不 是 太 理想 而 已 。 
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Ea 


A 1-4: Rango 应 用 中 两 个 主要 实体 的 ER 图 


图 做 好 记录 M 


要 养 成 习惯 ， 把 所 做 的 假设 记录 下 来 ， 例 如 这 里 假设 的 一 对 多 关系 ， 以 防 以 后 出 问题 。 有 了 
记录 ， 你 便 可 以 与 开发 团队 沟通 ， 确 保 他 们 考虑 到 了 你 的 假设 。 


根据 这 一 假设 ， 我 们 可 以 通过 表格 列 出 各 实体 的 详细 内 容 ， 指 明 各 实体 中 有 哪些 字段 。 我 们 使 用 
Django 的 ModelField 类 型 定义 各 字段 的 类 型 ( 即 IntegerField、CharField、URLField 或 
ForeignKey) 。 注 意 ， 在 Django 中 主键 (primary key) AGW, Django 会 为 各 模型 添加 id 字 
Be 〈 详 情 参见 第 5 章 ) 。 


表 1-1: Category 模型 表 1-2: Page 模型 
字段 类 型 字段 类 型 
name CharField category ForeignKey 
views IntegerField title CharField 
likes IntegerField url URLField 
views IntegerField 


此 外 ， 还 需要 一 个 User 模型 ， 以 便 用 户 注册 和 登录 。 这 里 没有 给 出 User 模型 ， 讨 论 用 户 身 份 验 
证 时 再 介绍 。 后 面 的 章节 将 说 明 如 何在 Django 中 定义 这 些 模 型 ， 以 及 如 何 使 用 内 置 的 ORM 连接 
数据 库 。 


1.5 小 结 


这 些 整体 上 的 设计 和 要 求 将 在 构建 Web 应 用 的 过 程 中 为 我 们 提供 参考 。 虽 然 我 们 将 集中 精力 说 明 
如 何 使 用 特定 的 技术 ， 但 是 多 数 数 据 库 驱动 的 网 站 都 是 这 么 规划 的 。 因 此 ， 你 最 好 能 熟练 地 阅读 
和 制定 这 样 的 要 求 和 设计 ， 以 便 与 人 顺畅 沟通 。 本 书 将 使 用 Django 和 相关 的 技术 实现 这 里 制定 的 
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Dil 


要 求 。 


o 复制 粘贴 代码 多 


阅读 本 书 的 过 程 中 ， 你 可 能 会 把 书 中 的 代码 复制 粘贴 到 代码 编辑 器 中 。 然 而 ， 笔 者 建议 上 自己 
动手 输入 代码 。 我 们 知道 自己 输入 稍 显 麻烦， 但 是 这 样 有 助 于 你 理解 整个 过 程 ， 还 能 证 你 记 
住 以 后 用 得 到 的 命令 。 


此 外 ， 复 制 粘贴 Python 代码 简直 就 是 自 找 麻 烦 。 复 制 的 空白 可 能 变 成 空格 、 制 表 符 或 二 者 
混杂 。 这 样 可 能 导致 各 种 奇怪 的 问题 ， 而 且 不 一 定 是 由 缩 进 引 起 的 。 如 果 你 确实 想 复 制 粘贴 
代码 ， 一 定 要 留神 这 样 的 问题 。 如 果 你 使 用 的 是 Python 3， 对 这 样 的 问题 要 格外 小 心 ， 因 为 
混用 制 表 符 和 空格 缩 进 会 导致 TabError。 


多 数 代码 编辑 器 都 能 显示 空白 ， 而 且 会 区 分 制 表 符 和 空格 。 如 果 你 使 用 的 编辑 器 有 这 样 的 功 
能 ， 一 定 要 局 用， 免得 分 不 清 。 
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图 灵 社 区 会 员 BRAE2018(wusijing2018@163.com) FS 尊重 版 权 


前 期 准备 工作 


开始 编程 之 前 ， 我 们 要 搭建 好 Django 所 需 的 开发 环境 。 我 们 要 在 自己 的 电脑 中 安装 所 需 的 全 部 组 
件 。 本 章 概述 要 安装 和 使 用 的 5 个 关键 组 件 。 

终端 或 命令 提示 符 

Python 

Python 包 管 理 器 和 虚拟 环境 

集成 开发 环境 (如果 你 想 用 的 话 ) 

版 本 控制 系统 Git 


U U O O de 


如 果 你 的 电脑 中 已 经 安装 了 Python 2.7/3.4/3.5 和 Django 1.9/1.10， 而 且 熟 悉 前 述 工具 ， 可 以 直接 
路 到 第 3 章 。 否 则 ， 请 阅读 下 面 对 这 些 组 件 的 介绍 ， 以 及 它们 在 开发 过 程 中 的 重要 性 。 我 们 还 将 
指出 这 些 组 件 的 安装 方式 。 


x 开发 环境 x 


搭建 开发 环境 是 个 繁琐 的 过 程 ， 很 容易 出 错 ， 但 不 是 每 天 都 要 做 。 本 章 介 绍 这 其 中 涉及 的 关 
键 技术 ， 以 及 如 何 安装 各 个 组 件 。 


根据 笔者 的 经 验 ， 建 议 你 把 搭建 的 步 又 记录 下 来 。 说 不 定 有 一 天 你 会 用 到 ， 例 如 你 买 了 新 电 
脑 ， 或 者 帮助 别人 。 现 在 做 的 记录 能 为 以 后 节省 时 间 和 精力 。 不 要 只 看 眼前 ! 


2.1 Python 


本 书 要 求 你 在 自己 的 电脑 中 安装 Python 编程 语言 ，2.7 系列 (E 2.7.5) 或 3.4 版 本 以 上 都 行 。 


如 果 你 不 知道 如 何 安装 Python， 需 要 帮助 ， 请 阅读 A.1 市 。 


* 不 会 用 Python? x 


如 果 你 没 用 过 Python， 或 者 想 提升 自己 的 技能 ， 笔 者 推荐 下 面 几 个 材料 : 


LI Stavros 写 的 Python 10 分 钟 速 成 教程 

口 Python 官方 教程 

4 Allen B. Downey 写 的 《 像 计算 机 科学 家 一 样 思考 Python} 
1 Jennifer Campbell 和 Paul Gries 开设 的 “学 习 编 程 ”课程 


这 几 个 材料 能 让 你 熟悉 Python 的 基础 知识 ， 以 便 开始 使 用 Django 开发 应 用 。 注 意 ， 为 了 使 
用 Django， 你 无 需 变 身 专家 。Python 是 门 优秀 的 语言 ， 如 果 你 会 用 其 他 编程 语言 ， 可 以 边 
用 边 学 。 


2.2 Python 包 管 理 器 


pip 是 Python 的 包 管 理 器 。 你 可 以 使 用 pip 安装 各 种 库 ， 增 强 Python 的 功能 。 


包 管 理 器 ， 不 管 是 针对 Python 的 、 针 对 操作 系统 的 ， 还 是 针对 其 他 环境 的 ， 是 一 种 自动 安装 、 升 
级 、 配 置 和 删除 包 的 软件 ， 解 放 了 你 的 双手 ， 无 需 你 自己 动手 下 载 、 安 装 和 维护 软件 。Python 包 
管理 起 来 可 不 简单 。 多 数 包 通 常 有 依赖 (dependency) ， 要 随 包 一 起 安装 。 因 此 ， 包 之 间 可 能 有 
冲突 ， 需 要 依赖 特定 的 版 本 。 此 外 ， 包 的 系统 路 径 也 要 指定 和 维护 。 笠 好 ， 这 些 繁 琐 的 工作 都 由 
pip 代为 处 理 了 ， 解 放 了 我 们 的 生产 力 。 


使 用 pip 命令 运行 pip 试 试看 。 如 果 提 示 找 不 到 pip 命令 ， 说 明 你 要 安装 pip。 详 情 参见 附录 A, 
你 还 要 确保 自己 的 系统 中 安装 了 下 面 两 个 包 。 执 行 下 述 命令 ， 安 装 Django 和 Pillow (处 理 图 像 的 
Python JÆ) ; 


S pip install -U django==1.9.10 
$ pip install pillow 


E 无 法 成 功 安 装 Pillow? W 


安装 Pillow 时 可 能 会 报错 ， 提 示 缺 少 JPEG 支持 ， 如 下 所 示 : 
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ValueError: jpeg is required unless explicitly disabled using 
--disable-jpeg, aborting 


如 果 你 遇 到 这 个 问题 ， 禁 用 JPEG 支持 试 试 : 


$ pip install pillow --global-option="build_ext" 
--global-option="- -disable- jpeg" 


这 样 虽然 无 法 处 理 JPEG 图 像 ， 但 是 却 能 成 功 安装 Pillow。 本 书 只 要 求 能 安装 Pillow 就 行 


了 。 详 情 参 见 Pillow 文档 。 


2.3 虚拟 环境 


环境 就 快 搭建 好 了 。 但 是 在 继续 之 前 要 注意 一 点 ， 目 前 的 环境 虽然 可 以 使 用 了 ， 但 是 有 些 缺 点 。 
如 果 另 一 个 应 用 要 使 用 Python 的 其 他 版 本 才能 运行 怎么 办 ? 如 果 你 想 把 Django 换 成 最 新 版 ， 但 
是 依然 想 维护 使 用 Django 1.9 开发 的 项 目 又 怎么 办 ? 2 


答案 是 使 用 虚拟 环境 。 借 助 虚拟 环境 ， 我 们 可 以 让 不 同 的 Python 版 本 和 同一 个 包 的 不 同 版 本 和 谐 
相处 。 如 今 ， 这 是 人 们 普 近 使 用 的 Python 环境 搭建 方式 。 


虽然 不 必须 使 用 虚拟 环境 ， 但 是 强烈 建议 你 使 用 。 搭 建 、 创 建 和 使 用 虚拟 环境 的 详细 说 明 参 见 
A4 节 。 


2.4 集成 开发 环境 


集成 开发 环境 (Integrated Development Environment，IDE) 虽然 不 是 必须 的 ， 但 一 个 支持 Python 
的 好 IDE 能 为 开发 工作 提供 极 大 的 帮助 。 支 持 Python 的 IDE 很 多 ，JetBrains 出 品 的 PyCharm 和 
PyDev (Eclipse 的 插件 ) 或 许 是 其 中 最 受 欢迎 的 。Python Wiki 中 有 支持 Python 的 IDE 的 最 新 列 
表 。 


自己 研究 一 下 ， 找 出 合用 的 。 注 意 ， 有 些 IDE 需要 购买 许可 证 。 如 果 你 选择 的 IDE 能 集成 Djan- 
go， 那 就 更 好 了 。 


笔者 使 用 的 是 PyCharm， 因 为 它 支 持 虚 拟 环境 ， 而 且 能 集成 Django (不 过 需要 配置 ) 。 这 里 不 讨 
论 如 何 集成 Django， 如 果 你 想 知 道 ， 可 以 阅读 JetBrains 网 站 中 介绍 PyCharm 集成 Django 的 文 
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2.5 代码 仓库 


最 后 ， 开 发 过 程 中 应 该 把 代码 纳入 版 本 控制 系统 ， 例 如 SVN 或 Git。 为 了 不 脱离 主线 ， 这 里 不 说 
明 如 何 使 用 版 本 控制 器 系统 。 寿 想 快 速 掌握 Git， 推 荐 阅读 《GitHub 入 门 与 实践 》 一 书 。 强 烈 建 议 
你 为 自己 的 项 目 创建 一 个 Git 仓库 。 


</> 练习 


为 了 熟悉 搭建 环境 的 步骤 ， 请 尝试 完成 以 下 练习 : 


安装 Python 2.7.5+/3.4+ 和 pip 

熟悉 命令 行 界 面 ， 创 建 一 个 名 为 workspace 的 目录 ， 我 们 创建 的 项 目 将 保存 在 这 里 
搭建 虚拟 环境 〈 选 做 ) 

安装 Django 和 Pillow 

如 果 没 有 Git 仓库 托管 网 站 (例如 GitHub、BitBucket， 等 等 ) 的 账号 ， 注 册 一 个 
下 载 并 设置 一 个 IDE, 例如 PyCharm 


Eee ee O 


前 面 说 过 ， 本 书 的 内 容 和 示例 应 用 在 一 个 GitHub 仓库 中 。 


J 如 采 你 发 现 错误 或 其 他 问题 ， 请 在 GitHub 中 提出 ， 让 我 们 知道 
了 如 果 碰 到 做 不 出 的 练习 ， 可 以 参照 仓库 中 的 代码 


太 目录 是 什么 ? x 


前 面 的 练习 中 有 一 题 让 你 创建 一 个 目录 (directory) ， 可 目录 究竟 是 什么 呢 ? 如 果 你 一 直 使 


用 Windows 系统 ， 目 录 就 是 文件 夹 (folder) 。 二 者 在 概念 上 是 一 样 的 ， 都 是 一 种 目录 结 
构 ， 列 出 里 面 的 文件 和 目录 。 
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下 面 开 始 学 习 Django。 本 章 介绍 如 何 新 建 项 目 和 Web 应 用 ， 最 终 让 一 个 Django 驱动 的 简单 网 站 
运行 起 来 。 


3.1 检查 环境 


首先 ， 我 们 要 检查 有 没有 正确 安装 Python 和 Django。 请 打开 一 个 新 终端 窗口 ， 执 行 下 述 命 令 ， 查 
看 Python 的 版 本 。 


$ python --version 


得 到 的 结果 应 该 是 2.7.11 3.5.1, Wet 2.7.54 或 3.4+ 版 的 Python 也 可 以 。 如 果 需 要 安装 或 升级 
Python, ， 请 翻 到 附录 A. 


如 果 你 想 使 用 虚拟 环境 ， 记 得 激活 。 倘 若 不 记得 怎么 操作 了 ， 请 翻 到 A.4 i, 


确认 Python 正确 安装 之 后 ， 还 要 检查 Django。 在 终端 窗口 中 执行 下 述 命令 ， 运 行 Python 解释 
ite 


$ python 

Python 2.7.10 (default, Jul 14 2015, 19:46:27) 

[GCC 4.2.1 Compatible Apple LLVM 6.0 (clang-600.0.39)] on darwin 

Type "help", "copyright", "credits" or "License" for more information. 


>>> 
在 提示 符 后 输入 下 述 命令 : 


>>> import django 
>>> django.get_version() 
'1.9.10' 
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>>> exit() 


如 果 一 切 正常 ， 应 该 能 看 到 Django 的 版 本 号 。 然 后 输入 exit()， 退 出 Python 解释 器 。 如 果 无 法 
导入 Django， 确 认 你 是 不 是 在 虚拟 环境 中 ， 再 使 用 pip list 命令 查看 安装 的 包 。 


如 果 不 知 如 何 安装 包 ， 或 者 安装 的 版 本 不 对 ， 请 翻 到 附录 A， 或 者 阅读 Django 文档 中 的 安装 说 
明 。 


E 提示 符 m 


本 书 代码 片段 中 有 两 种 符号 要 注意 。 
以 美元 符号 ($) 开头 的 代码 片段 ， 其 后 的 内 容 是 要 在 终端 或 命令 提示 符 中 运行 的 命令 。 


>>> 表示 后 面 的 命令 要 输入 交互 式 Python 解释 器 。 解 释 器 打开 的 方法 是 执行 python 命令 ， 
退出 方法 是 输入 exit()。 


3.2 创建 Django 项 目 


进入 workspace 目录 ， 执 行 下 述 命令 ， 新 建 一 个 Django 项 目 : 
$ django-admin.py startproject tango_with_django_ project 


如 果 你 的 电脑 中 没有 workspace 目录 ， 那 就 创建 一 个 ， 把 Django 项 目 和 其 他 项 目 都 保存 在 那里 。 
我 们 将 在 代码 中 使 用 <workspace> 指 代 你 的 workspace 目录 。 你 要 把 <workspace> 替换 成 work- 
space 目录 的 具体 路 径 ， 例 如 /Users/leifos/Code/ 或 /Users/maxwelld90/Workspace/。 


* 找 不 到 django-admin.py? * 


输入 django-admin 试 试 。 根 据 采 用 的 安装 方式 ， 有 些 系统 可 能 无 法 识别 django-admin.py, 


根据 Stack Overflow 中 这 个 问答 的 建议 ， 在 Windows 系统 中 可 能 要 使 用 django-admin py fil 


本 的 完整 路 径 ， 例 如 : 


python c:\python27\scripts\django-admin. py 
startproject tango_with_django_ project 
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者 喜欢 在 Django 项 目 所 在 的 目录 名 后 面 加 上 _project， 明 确 表明 目录 中 是 什么 。 不 过 , 具 
Ly 


体 怎么 命名 完全 由 你 自己 决定 。 


此 时 你 会 发 现 ， 你 的 workspace 目录 中 出 现 了 与 项 目 同名 的 一 个 目录 ， 即 tango_with_django_pro- 
ject。 在 这 个 目录 中 你 会 看 到 两 个 内 容 : 


4 另 一 个 与 项 目 同名 的 目录 
1 一 个 Python 脚本， 名 为 manage py 


在 本 书 中 ， 我 们 将 把 内 部 那个 tango_with_django_project 目录 称 为 项 目 配置 目录 。 在 这 个 目录 
中 ， 你 会 看 到 4 个 Python 脚本 ， 下 面 简单 介绍 一 下 ， 后 文 再 详细 说 明 : 


J _init_.py: 一 个 空 Python 脚本 ， 存 在 的 目的 是 告诉 Python 解释 器 ， 这 个 目录 是 一 个 
Python 包 ; 

A settings.py: 存放 Django 项 目的 所 有 设置 ， 

J urls.py: 存放 项 目的 URL 模式 ， 

wsgipy: 用 于 运行 开发 服务 器 和 把 项 目 部 署 到 生产 环境 的 一 个 Python 脚本 。 


项 目 目 录 中 有 个 名 为 manage py 的 文件 ， 在 开发 过 程 中 时 常用 到 。 它 提供 了 一 系列 维护 Django 项 
目的 命令 ,例如 通过 它 可 以 运行 内 置 的 Django 开发 服务 器 ， 可 以 测试 应 用 ， 还 可 以 运行 多 个 数据 
库 命 令 。 几 乎 每 个 Django 命令 都 要 调用 这 个 脚本 。 


* Django 管理 脚本 * 


Django 管理 脚本 的 详细 说 明 参 见 Django 文档 。 


执行 python manage.py help 命令 可 以 查看 可 用 命令 列表 。 


你 现在 就 可 以 使 用 manage py 脚本 ， 执 行 下 述 命令 试 试 : 


$ python manage.py runserver 


这 个 命令 启动 Python， 让 Django 运行 内 置 的 轻 量 级 开发 服务 器 。 你 在 终端 窗口 中 应 该 会 看 到 类 似 
下 面 的 输出 : 


$ python manage.py runserver 
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Performing system checks... 
System check identified no issues (0 silenced). 


You have unapplied migrations; your app may 
not work properly until they are applied. 


Run ‘python manage.py migrate’ to apply them. 


October 2, 2016 - 21:45:32 

Django version 1.9.10, using settings ‘tango _with_django_project.settings' 
Starting development server at http://127.0.0.1:8000/ 

Quit the server with CONTROL-C. 


从 这 段 输出 可 以 看 出 几 件 事 。 首 和 完 ， 没有 出 现 阻 碍 应 用 运行 的 问题 。 但 是 ， 输 出 中 有 个 提醒 ， 指 
出 有 未 应 用 的 迁移 。 这 个 问题 在 设置 数据 库 时 再 讨论 ， 现 在 暂且 和 忽略。 最 后 ， 尤 为 重要 的 是 一 个 
URL 地 址 ， 即 http://127.0.0.1:8000/， 这 是 Django 开发 服务 器 的 地 址 。 


打开 Web 浏览 器 ， 输 入 URL http:1/127.0.0.1:8000/。 你 将 看 到 类 似 图 3-1 的 网 页 。 


127.0.0.1 © rr 


It worked! 
Congratulations on your first Django-powered page. 


Of course, you haven't actually done any work yet. Next, start your first app by running python manage.py 
startapp [app_label]. 


You're seeing this message because you have DEBUG = True in your Django settings file and you haven't 
configured any URLs. Get to work! 


图 3-1: 首次 运行 Django 开发 服务 器 时 看 到 的 页 面 


开发 服务 器 随时 可 以 停止 ， 只 需 在 终端 或 命令 提示 符 窗 口中 按 CTRL+C 键 。 如 果 想 在 其 他 端口 上 运 
行 开发 服务 器 ， 或 者 允许 其 他 设备 访问 ， 可 以 提供 可 选 的 参数 。 例 如 下 述 命令 : 


$ python manage.py runserver <your_machines_ip_address>:5555 
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这 个 命令 强制 开发 服务 器 在 TCP 端口 5555 上 响应 入 站 请 求 。 记 得 把 <your_machines_ip_address> 
换 成 你 电脑 的 IP 地 址 或 127.0.0.1。 


* 不 知道 自己 的 IP 地 址 ? x 


使 用 0.0.0.0, Django 能 找 出 你 的 IP 地 址 。 不 信 可 以 试 试 : 


$ python manage.py runserver 0.0.0.0:5555 


设置 端口 时 ， 不 要 使 用 80 或 8080， 这 一 般 是 为 HTTP 保留 的 。 此 外 ， 低 于 1024 的 端口 是 操作 系 
统 专属 的 。， 


虽然 部 署 应 用 时 不 会 使 用 这 个 轻 量 级 的 开发 服务 器 ， 但 是 能 让 同一 网 络 中 的 其 他 设备 访问 你 的 应 
用 还 是 有 必要 的 。 使 用 你 的 设备 的 IP 地 址 运行 服务 器 能 让 他 人 通过 http -//<your_machines_ip_ad- 
dress>:<port> 访问 你 的 应 用 。 当 然 ， 这 要 看 你 的 网 络 是 怎么 配置 的 ， 可 能 要 设置 代理 服务 器 或 防 
火 墙 。 如 果 无 法 远程 访问 开发 服务 咒 ， 请 向 网 络 管理 员 寻 求 帮助 。 


3.3 创建 Django 应 用 


— Django 项 目 中 包含 一 系列 配置 和 应 用 ， 这 些 在 一 起 共同 构成 一 个 完整 的 Web 应 用 或 网 站 。 
这 样 做 便于 运用 优秀 的 软件 工程 实践 。 把 一 个 Web 应 用 分 解 为 多 个 小 应 用 的 好 处 是 ， 可 以 把 那些 
小 应 用 放 到 别 的 Django 项 目 中 ， 无 需 做 多 少 改动 就 能 使 用 。 


— Django 应 用 完成 一 件 特殊 的 任务 。 一 个 网 站 需要 多 少 应 用 ， 要 视 其 功能 而 定 。 例 如 ， 一 个 项 
目 中 可 能 包含 一 个 投票 应 用 、 一 个 注册 应 用 和 一 个 与 内 容 有 关 的 应 用 。 在 另 一 个 项 目 中 ， 我 们 可 
能 想 复 用 投票 和 注册 应 用 ， 因 此 可 以 把 它们 拿 过 来 用 。 稍 后 再 详细 说 明 。 下 面 创建 Rango 应 用 。 


Æ Django 项 目 所 在 的 目录 (例如 <workspace>/tango_with_django_project) 中 执行 下 述 命令 : 


$ python manage.py startapp rango 


startapp 目录 在 项 目的 根 目录 中 创建 一 个 新 目录 ， 你 可 能 猜 到 了 ， 这 个 目录 名 为 rango， 其 中 包 
含 一 些 Python 脚本 : 


Q init py: 与 前 面 那个 的 作用 完全 一 样 ， 


1. https://www.w3 .org/Daemon/User/Installation/PrivilegedPorts.html 
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admin py: 注册 模型 ， 让 Django 为 你 创建 管理 界面 ; 

apps. py: 当前 应 用 的 配置 

models py: 存放 应 用 的 数据 模型 ， 即 数据 的 实体 及 其 之 间 的 关系 
tests.py: 存放 测试 应 用 代码 的 函数 ， 

views py: 存放 处 理 请 求 并 返回 响应 的 函数 ， 

migrations 目录 : 存放 与 模型 有 关 的 数据 库 信 息 。 


U U UHU U E O 


views py 和 models py 是 任何 应 用 中 都 有 的 两 个 文件 ， 是 Django 所 采用 的 设计 模式 〈 即 “模型 -视图 
-模板 "模式 ) 的 主要 部 分 。 如 果 想 深入 了 解 模型 、 视 图 和 模板 之 间 的 关系 ， 请 阅读 Django 文档 。 


在 动手 创建 模型 和 视图 之 前 ， 必 须 告 诉 Django 项 目 这 个 新 应 用 的 存在 。 为 此 ， 要 修改 项 目 配置 目 
录 中 的 settings py 文件 。 打 开 那 个 文件 ， 找 到 INSTALLED_APPS 列表 ， 把 rango 添加 到 末尾 : 


INSTALLED_APPS = [ 
‘django.contrib.admin', 
‘django.contrib.auth', 
"django.contrib.contenttypes', 
'django.contrib.sessions', 
‘django.contrib.messages', 
‘django.contrib.staticfiles', 
"rango ' ， 


] 


再 次 运行 开发 服务 器 ， 确 认 Django 识别 了 这 个 新 应 用 。 如 果 能 正常 启动 开发 服务 器 ， 没 有 任何 错 
误 ， 说 明 新 应 用 已 经 成 功 识别 ， 可 以 进入 下 一 步 了 。 


* startapp 的 自动 操作 x 


使 用 python manage.py startapp 命令 创建 应 用 时 ，Django 可 能 会 把 新 应 用 的 名 称 自动 添加 


到 settings py 中 的 INSTALLED_APPS 列表 里 。 尽 管 如 此 ， 在 继续 之 前 自己 再 检查 一 下 也 没什么 
错 。 


3.4 编写 视图 


创建 好 Rango 应 用 后 ， 下 面 编写 一 个 简单 的 视图 。 这 是 我 们 编写 的 第 一 个 视图 ， 简 单 起 见 ， 暂 不 
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使 用 模型 或 模板 ， 而 是 把 一 些 文本 发 回 给 客户 端 。 

在 你 选择 的 IDE 中 打开 新 建 的 rango 目录 里 的 views py 文件 。 把 # Create your views here 这 行 
注释 删 掉 ， 得 到 一 个 空 文件 。 

然后 ， 写 入 下 述 代 码 : 


from django.http import HttpResponse 


def index(request): 
return HttpResponse("Rango says hey there partner!") 


下 面 分 析 一 下 这 三 行 代码 ， 看 这 个 简单 的 视图 是 如 何 运 作 的 : 


J 首先 ， 从 django.http 模块 中 导入 HttpResponse 对 象 。 

J Æ views py 文件 中 ， 一 个 函数 就 是 一 个 视图 。 这 里 我 们 只 编写 了 一 个 视图 ， 即 index, 

J 视图 函数 至 少 有 一 个 参数 ， 即 一 个 HttpRequest 对 象 ， 它 也 在 django.http 模块 中 。 按 约 
定 ， 这 个 参数 名 为 request， 不 过 你 可 以 根据 自己 的 意愿 随意 使 用 其 他 名 称 。 

口 视图 必须 返回 一 个 HttpResponse 对 象 。 简 单 的 HttpResponse 对 象 的 参数 是 一 个 字符 串 ， 表 

示 要 发 给 客户 端的 页 面 内 容 。 


有 了 视图 还 不 行 ， 为 了 让 用 户 能 访问 视图 ， 要 把 一 个 统一 资源 定位 地 址 (Uniform Resource Loca- 
tor, URL) 映射 到 视图 上 。 


为 此 ， 打 开 项 目 配置 目录 中 的 urls py CHE, FE urlpatterns 中 添加 一 行 代码 : 


from rango import views 


urlpatterns = [ 
url(r'^$', views.index, name='index'), 
url(r'*admin/', admin.site.urls), 


] 


新 加 的 那 行 代码 把 根 URL 映射 到 rango 应 用 的 index 视图 上 。 局 动 开发 服务 器 (python 
manage.py runserver) ， 访 问 Attp://127.0.0.1:8000 或 你 指定 的 其 他 地 址 。 你 将 看 到 index 视图 泻 
染 的 输出 。 
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3.5 PRAT URL 


为 了 提升 模块 化 程度 ， 我 们 可 以 换 种 方式 把 入 站 URL 映射 到 视图 上 ， 而 不 直接 在 项 目 层 设置 。 首 
先 ， 要 修改 项 目的 urlspy 文件 ， 把 针对 Rango 应 用 的 请 求 交 给 Rango 应 用 处理 。 然 后 ， 在 Rango 
应 用 中 指定 如 何 处 理 请 求 。 


首先 ， 打 开 项 目 配 置 目录 中 的 urls.py 文件 。 相 对 workspace 目录 而 言 ， 这 个 文件 的 地 址 是 <work- 
space>/tango_with_django_project/tango_with_django_project/urlspy。 把 urLpatterns 列表 改 成 下 面 
这 样 : 


from django.conf.urls import url 
from django.contrib import admin 
from django.conf.urls import include 
from rango import views 


urlpatterns = [ 
url(r'^$', views.index, name='index'), 
url(r'“rango/', tnclude('rango.urls')), 
# 上 面 的 映射 把 以 rango/ 开头 的 URL 交 给 rango MA RH 
url(r'*admin/', admin.site.urls), 


] 


可 以 看 出 ，urlpatterns 是 个 Python 列表 。 新 增 的 映射 寻找 能 匹配 “rango/ 模式 的 URL, i Bix 
样 的 URL IY, rango/ 后 面 的 部 分 传 给 Rango， 由 rango.urls 处 理 。 这 一 步 是 通过 
django.conf.urls 模块 中 的 include() 函数 实现 的 。 


这 是 一 种 分 段 处 理 URL 字符 串 的 方式 ， 如 图 3-2 所 示 。 这 里 ， 完 整 的 URL 先 去 掉 域 名 ， 余 下 的 
部 分 (rango/) 传 给 tango_with_django 项 目 ， 找 到 匹配 的 映射 后 ， 再 把 rango/ 去 掉 ， 把 空 字 符 串 
传 给 rango 应 用 处 理 。 


域名 项 目 配置 目录 中 的 urls.py Rango 应 用 中 的 urls.py 


图 3-2: 分 段 处 理 URL， 域 名 后 的 不 同 的 部 分 由 不 同 的 Urlpy 文件 处 理 


根据 上 述 设 置 ， 我 们 要 在 rango 应 用 的 目录 中 新 建 urls.py 文件 ， 让 它 处 理 余下 的 URL ( 即 把 空 字 
符 串 映射 到 index 视图 上 ) : 


from django.conf.urls import url 
from rango import views 
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urlpatterns = [ 
url(r'^$', views.index, name='index'), 


] 


这 上 段 代码 先导 人 Django 处 理 URL 映射 的 函数 和 Rango 应 用 的 views 模块 ， 然 后 在 urlpatterns 
列表 中 调用 url 函数 映射 index 视图 。 


本 书 所 指 的 URL 字符 串 ， 都 是 去 掉 主 机 地 址 后 的 部 分 。 主 机 地 址 是 指 癌 Web 服务 器 的 地 址 或 域 
名 ， 例 如 http:W127.0.0.1:8000 或 http://www.tangowithdjango-china.com。 去 掉 主 机 地 址 后 ，Django 
便 只 需 处 理 URL 中 余下 的 部 分 。 例 如 ， 对 http://127.0.0.1:8000/rango/about/ 这 个 URL 来 说 ， 
Django 得 到 的 URL 字符 串 是 /rango/about/。 


上 述 代码 中 的 URL 映射 调用 Django 的 urt) 函数 ， 其 第 一 个 参数 是 正则 表达 式 ^。 这 个 正则 表 
达 式 匹配 空 字符 串 ， 因 为 ^ 表 示 开 头 ，$ 表示 结尾 ， 而 且 二 者 之 间 没 有 任何 内 容 ， 所 以 只 能 匹配 

空 字符 串 。 用 户 访 问 的 URL， 只 要 匹配 这 个 模式 ，Django 就 会 调用 views.index() 视图 。 你 可 能 
觉得 匹配 空 URL 没有 什么 意义 ， 那 为 什么 要 这 样 做 呢 ? 还 记得 吗 ， 匹 配 URL 模式 时 ， 只 会 考虑 
JR URL 的 一 部 分 。Django 先 使 用 项 目的 URL 模式 处 理 URL 字符 串 (rango/) ， 去 掉 rango/ 部 
分 之 后 得 到 空 字符 。 然 后 把 空 字符 串 传 给 Rango 应 用 ， 交 给 rango/urls.py 中 的 URL 模式 处 理 。 


传 给 urL() 函数 的 下 一 个 参数 是 index 视图 ， 指 明 处 理 人 站 请 求 的 函数 。 后 面 的 name 参数 是 可 选 
的 ， 这 里 把 它 设 为 字符 串 'index' 。 为 URL 命名 的 目的 是 反 向 解析 URL， 即 通过 名 称 引 用 URL 
映射 ， 而 不 直接 使 用 URL。 讲 到 模板 时 再 说 明 这 一 点 。 如 果 想 深入 了 解 这 个 话题 ， 请 阅读 Django 
文档 , 


现在 ， 重 启 Django 开发 服务 器， 然后 访问 http://127.0.0.1:8000/rango/。 如 果 一 切 正常 ， 你 应 该 能 
看 到 文本 “Rango says hey there partner!”， 如 图 3-3 所 示 。 


127.0.0.1 © + 


Rango says hey there partner! 


A 3-3: Web 浏览 器 中 显示 着 首 个 由 Django 驱动 的 网 页 


每 个 应 用 中 都 可 以 有 一 些 URL 映射 。 一 开始 ，URL 映射 十 分 简单 ， 不 过 随 着 开发 的 深入 ， 我 们 
将 添加 更 多 复杂 的 参数 化 URL 映射 。 


你 要 理解 Django 处 理 URL 的 方式 。 现 在 你 可 能 还 有 点 迷糊 ， 不 过 用 得 多 了 ， 和 终究 会 明白 的 。 如 
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果 想 深入 了 解 URL 映射 ， 想 看 更 多 的 示例 ， 请 阅读 Django 文档 。 


x 正则 表达 式 六 


Django 的 URL 模式 使 用 正则 表达 式 匹 配 URL， 因 此 你 要 熟练 使 用 Python 的 正则 表达 式 。 


Python 官方 文档 中 有 一 篇 关于 正则 表达 式 的 指南 ， 此 外 也 可 以 查看 Regex Cheat Sheet 网 站 中 


的 速 查 表 。 


如 果 使 用 版 本 控制 系统 ， 现 在 是 提交 改动 的 好 时 机 。 


3.6 基本 流程 


本 章 内 容 可 以 总 结 为 一 系列 操作 。 这 一 节 给 出 我 们 所 执行 的 两 个 任务 的 操作 步 又 。 如 果 以 后 记 不 
得 了 ， 可 以 随时 翻阅 。 


创建 Django 项 目 


© 执行 python django-admin.py startproject <name> 命令 ， 其 中 <name> 是 想 创建 的 项 目 名 
称 。 


创建 Django 应 用 


© 执行 python manage.py startapp <appname> 命令 ， 其 中 <appname> 是 想 创建 的 应 用 名 称 。 


o 把 应 用 名 称 添加 到 项 目 配 置 日 录 中 的 settings py 文件 里 ， 放 到 INSTALLED_APPS 列表 的 末 
尾 ， 告 诉 Django 项 目 这 个 应 用 的 存在 。 


© 在 项 目的 urls.py 文件 中 添加 一 个 映射 ， 指 向 新 建 的 应 用 。 
@ 在 应 用 的 目录 中 新 建 urls.py 文件 ， 把 人 站 URL 与 视图 对 应 起 来 。 
@ ZEMAN view py 文件 中 编写 所 需 的 视图 ， 确 保 视 图 返回 一 个 HttpResponse 对 象 。 
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</> 练习 


我 们 创建 了 一 个 Django 项 目 ， 而 且 把 新 建 的 应 用 运行 起 来 了 。 请 试 着 完成 以 下 练习 ， 巩 固 所 
学 的 知识 。 走 到 这 一 步 不 简单 ， 是 学 习 Django 过 程 中 的 一 个 重要 里 程 碑 。 编 写 视 图 并 把 
URL 映射 到 视图 上 是 开发 更 加 复杂 的 Web 应 用 所 必须 迈 出 的 第 一 步 。 


J 回顾 本 章 的 内 容 ， 确 保 自己 理解 了 URL 是 如 何 映射 到 视图 上 的 。 
J 再 编写 一 个 视图 函数 ， 名 为 about， 返 回 “Rango says here is the about page.”。 


J 把 这 个 视图 映射 到 URL /rango/about/ 上 。 只 需 编辑 Rango 应 用 的 urls.py 文件 。 
住 ，/rango/ 部 分 由 项 目的 urls py 文件 处 理 。 


J 修改 index 视图 中 的 HttpResponse 对 象 ， 加 入 一 个 指向 关于 页 面 的 链接 。 
J 在 about 视图 的 HttpResponse 对 象 中 添加 一 个 指向 主页 的 链接 。 


I 既然 开始 阅读 本 书 了 ， 那 就 在 Twitter 上 关注 @tangowithdjango 吧 ， 告 诉 我 们 你 学 的 
怎么 样 。 


太 提 示 太 


如 果 你 做 不 出 上 述 练习 ,希望 下 面 的 提示 能 给 


d Æ views py 文件 中 定义 一 个 函数 ，def about(request):， 让 它 返 回 一 个 HttpResponse 
对 象 ， 在 参数 中 指明 要 返回 的 HTML。 


匹配 URL about/ 的 正则 表达 式 是 r'^about/'。 在 rango/urls.py 文件 中 为 about() 视图 
增加 一 个 映射 。 


修改 index() 视图 ， 添 加 一 个 指向 about 视图 的 链接 。 简 单 起 见 ， 现 在 可 以 这 样 写 : 


Rango says hey there partner! <br/> <a href='/rango/about/'>About</a>. , 
J 同样 ， 在 about() 视图 中 添加 指向 首页 的 链接 : <a href="/rango/">Index</a>, 
J 如 果 你 还 没 读 过 Django 官方 教程 ， 现 在 请 阅读 第 一 部 分 。 
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模板 和 媒体 文件 


本 章 介绍 Django 的 模板 引擎 ， 并 说 明 如 何在 应 用 中 伺服 静态 文件 和 媒体 文件 。 


4.1 使 用 模板 


目前 ， 我 们 只 把 一 个 URL 映射 到 一 个 视图 上 。 然 而 ，Django 框架 采用 的 是 “模型 -视图 -模板 ” 染 
构 。 这 一 节 说 明 模 板 与 视图 的 关系 ， 后 面 几 章 再 讨论 如 何 与 模型 联系 起 来 。 


为 什么 使 用 模板 ? 网 站 中 的 不 同 页 面 通常 使 用 相同 的 布局 ， 提 供 通用 的 页 头 (header) 和 页 肢 
(footer) ， 为 用 户 呈 现 导航 ， 体 现 一 种 一 致 性 。Dijango 模板 能 让 开发 者 轻易 实现 这 样 的 设计 要 
求 ， 而 且 还 能 把 应 用 逻辑 〈 视 图 代码 ) 与 表现 (应 用 的 外 观 ) 区 分 开 。 本 章 将 创建 一 个 简单 的 模 
板 ， 用 于 生成 HIML 页 面 ， 交 由 Django 视图 调度 。 第 5 章 将 更 近 一 步 ， 结 合 模型 动态 分 发 数 
据 。 


x 总结， 模板 是 什么 ? * 


Django 的 模板 可 以 理解 为 构建 完整 的 HIML 页 面 所 需 的 骨架 。 模 板 中 有 静态 内 容 (不 变 的 


部 分 ) ， 也 有 特殊 的 句法 (动态 内 容 ， 即 模板 标签 ) 。Django 视图 会 把 动态 内 容 蔡 换 成 真正 
的 数据 ， 生 成 最 终 的 HTML 响应 。 


配置 模板 目录 


若 想 在 Django 应 用 中 使 用 模板 ， 要 创建 两 个 目录 ， 用 于 存放 模板 文件 。 


在 Django 项目 配置 目录 (<workspace>/tango_with_django_project/) 中 创建 一 个 名 为 templates 的 
目录 。 注 意 ， 这 个 目录 要 与 项 目的 manage py 脚本 放 在 同一 级 。 在 这 个 新 目录 中 再 创建 一 个 目 
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se, ZHN rango, RITE <workspace>/tango_with_django_project/templates/rango/ 目录 中 存放 
Rango 应 用 的 模板 。 


太 以 合理 的 方式 组 织 模板 太 


建议 把 各 应 用 的 模板 放 在 单独 的 子 目 录 中 。 这 就 是 我 们 在 templates 目录 中 创建 rango 子 目录 
的 原因 。 如 果 想 打包 应 用 ， 把 它 分 发 给 其 他 开发 者 ， 这 样 就 便于 区 分 模板 属于 哪个 应 用 。 


接 下 来 要 告诉 Django 你 把 模板 放 在 什么 位 置 。 打 开 项 目的 settings py 文件 ， 找 到 TEMPLATES。 如 
果 项 目 是 使 用 Django 1.9 创建 的 ，TEMPLATES 的 默认 内 容 如 下 : 


TEMPLATES = [ 
{ 
"BACKEND': 'django.tempLate.backends.django.DjangoTempLates', 
'DIRS': [], 
"APP_DIRS': True, 
‘OPTIONS': { 
‘context_processors': [ 
‘django. template.context_processors.debug', 
‘django. template.context_processors.request', 
'django.contrib.auth.context_processors.auth', 
'django.contrib.messages.context_processors.messages', 
] ， 
}， 
E 
] 


为 了 告诉 Django， 模 板 在 何 处 ， 我 们 要 修改 DIRS 列表 (默认 为 空 ) 。 把 这 个 键 值 对 改 成 下 面 这 
样 : 
'DIRS': ['<workspace>/tango with django_project/templates'] 


注意 ， 这 里 要 使 用 绝对 路 径 (absolute path) 。 然 而 ， 与 团队 成 员 协 作 ， 或 者 换 台 电脑 的 话 ， 这 就 
是 个 问题 了 。 用 户 名 和 磁盘 结构 变 了 ，<workspace> 目录 的 路 径 也 就 不 一 样 了 。 这 个 问题 的 一 种 解 
决 方法 是 列 出 每 个 可 能 的 路 径 ， 例 如 : 


'DIRS': [ '/Users/leifos/templates', 
'/Users/maxwelld90/templates', 
'/Users/davidm/templates', ] 
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可 是 这 样 做 也 有 诸多 问题 。 首 先 ， 每 增加 一 个 团队 成 员 就 要 增加 一 个 路 径 。 其 次 ， 如 果 换 成 其 他 
操作 系统 (例如 Windows) ， 和 斜 线 可 能 都 要 换 种 形式 。 


© 不 要 硬 编码 路 径 多 


硬 编码 路 径 是 自 找 麻烦 。 硬 编码 路 径 是 软件 工程 的 一 种 反 模 式 ， 会 导致 项 目 不 易 移植 ， 也 就 


是 说 在 一 台电 脑 中 运行 好 好 的 ， 换 台 设备 可 能 就 会 出 错 。 


更 好 的 方法 是 使 用 Python 内 置 的 函数 自动 找 出 templates 目录 的 路 径 。 这 样 无 论 你 把 Django M H 
的 代码 放 在 何 处 ， 最 终 都 能 得 到 一 个 绝对 路 径 。 因 此 ， 项 目的 可 移植 性 更 高 。 


settings. py 文件 的 顶部 有 个 名 为 BASE_DIR 的 变量 ， 它 的 值 是 settings py 文件 所 在 目录 的 路 径 。 这 
里 用 到 了 Python 的 特殊 属性 _fite _， 它 的 值 是 所 在 文件 的 绝对 路 径 。 调 用 os.path.dirname() 
的 作用 是 获取 settings py 文件 所 在 目录 的 绝对 路 径 ， 再 调用 一 次 os.path.dirname() 又 去 掉 一 层 ， 
因此 BASE_DIR 最 终 的 值 是 <workspace>/tansgo_with_django_project/。 如 果 你 还 不 太 理 解 这 个 过 
程 ， 可 以 把 下 面 几 行 代码 放 到 settings py 文件 中 : 


print(__file_) 
print(os.path.dirname(__file_)) 
print(os.path.dirname(os.path.dirname(__file_))) 


有 了 BASE_DIR 之 后 ， 我 们 便 可 以 轻易 引用 Django 项 目 中 的 文件 和 目录 。 我 们 可 以 定义 一 个 名 为 
TEMPLATE_DIR 的 变量 ， 指 向 templates 目录 的 位 置 。 这 里 还 要 使 用 0s.path.join() 函数 拼接 多 个 
路 径 片 段 。TEMPLATE_DIR 变量 的 定义 如 下 : 


TEMPLATE_DIR = os.path.join(BASE DIR, 'templates') 


我 们 使 用 os .path.join() 函数 把 BASE_DIR 变量 和 'templates' 字符 串 拼接 起 来 ， 得 到 
<workspace>/tango_with_django_project/templates/。 如 此 一 来 ， 我 们 便 可 以 使 用 TEMPLATE_DIR 
变量 替代 前 面 在 TEMPLATES 中 硬 编码 的 路 径 。 把 DIRS 键 值 对 改 成 下 面 这 样 : 


'DIRS': [TEMPLATE_DIR, ] 
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* 为 什么 命名 为 TEMPLATE_DIR? x 
我 们 在 settings py 文件 的 顶部 定义 了 一 个 名 为 TEMPLATE_DIR 的 变量 ， 采 用 这 个 名 称 是 因为 它 


能 表明 变量 的 作用 ， 而 且 基 本 不 会 修改 。 在 较 复 杂 的 Django 项 目 中 ， 可 以 在 DIRS 列表 中 指 
定 多 个 模板 目录 ， 但 是 本 书 用 这 一 个 就 够 了 。 


© 拼接 路 径 e 


拼接 系统 路 径 时 一 定 要 使 用 os.path.join() 函数 ， 这 样 为 的 是 使 用 正确 的 路 径 分 隔 符 。Unix 
操作 系统 〈 及 其 衍生 系统 ) 使 用 正 斜 线 (/) 分 隔 目 录 ， 而 Windows 操作 系统 使 用 反 和 斜 线 

(\) 。 如 果 直 接 使 用 斜 线 ， 更 换 操 作 系统 后 可 能 导致 路 径 错误 ， 从 而 降低 项 目的 可 移植 
性 。 


添加 一 个 模板 


模板 目录 和 路 径 设置 好 之 后 ， 在 templates/rango/ 目录 中 创建 一 个 文件 ， 命 名 为 index.html, TEX 
个 新 文件 中 写 人 下 述 HTML 代码 。 


<!DOCTYPE htmL> 
<htmL> 


<head> 
<title>Rango</title> 
</head> 


<body> 
<hi>Rango says...</h1> 
<div> 
hey there partner! <br /> 
<strong>{{ boldmessage }}</strong><br /> 
</div> 
<div> 
<a href="/rango/about/">About</a><br /> 
</div> 
</body> 


</html> 
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XE HTML 代码 很 好 理解 ， 最 终 得 到 的 HTML 页 面 将 向 用 户 打 个 招呼 。 你 可 能 注意 到 了 ， 这 里 
有 些 内 容 不 是 HTML， 而 是 {{ boldmessage }} 形式 。 这 是 Django 模板 变量 。 我 们 可 以 为 这 样 的 
变量 设 值 ， 这 样 泻 染 模板 后 便 会 显示 我 们 设 定 的 值 。 稍 后 再 做 。 


为 了 使 用 这 个 模板 ， 我 们 要 调整 一 下 前 面 编写 的 index() 视图 ， 不 再 分 发 一 个 简单 的 啊 应 对 象 ， 
而 是 分 发 这 个 模板 。 


打开 rango/views py 文件 ， 看 看 文件 顶部 有 没有 下 面 这 个 import 语句 。 如 果 没 有 ， 加 上 。 


from django.shortcuts import render 
然后 根据 下 述 代码 片段 修改 index() 视图 函数 。 各 行 代码 的 作用 参见 注释 。 


def index(request): 
# 构建 一 个 字典 ， 作 为 上 下 文 传 给 模板 引擎 
# 注意 ，boLdmessage 键 对 应 于 模板 中 的 {{ boldmessage }} 
context_dict = {'boldmessage': "Crunchy, creamy, cookie, candy, cupcake!"} 


# ABNER aA RAE P 5 

# 为 了 方便 ， 我 们 使 用 的 是 render 函数 的 简短 形式 

# 注意 ， 第 二 个 参数 是 我 们 想 使 用 的 模板 

return render(request, 'rango/index.html', context=context_dict) 


首先 ， 构 建 一 个 字典 ， 设 定 要 传 给 模板 的 数据 。 然 后 ， 调 用 render() 辅助 函数 。 这 个 函数 的 参数 
是 request 对 象 、 模 板 的 文件 名 和 上 下 文字 典 。render() 函数 将 把 上 下 文字 典 中 的 数据 代 人 模 
板 ， 生 成 一 个 完整 的 HTML 页 面 ， 作 为 HttpResponse 对 象 返 回 ， 分 发 给 Web 浏览 


太 模板 上 下 文 是 什么 ? 大 


Django 的 模板 系统 加 载 模板 文件 时 会 创建 一 个 模板 上 下 文 。 简 单 而 言 ， 模 板 上 下 文 是 一 个 
Python 字典 ， 把 模板 变量 名 映射 到 值 上 。 在 前 面 的 模板 中 ， 有 个 名 为 boldmessage 的 模板 变 


量 。 在 修改 后 的 index() 视图 中 ， 我 们 把 crunchy, creamy, cookie, candy, cupcake! 字符 


串 赋 给 模板 变量 boLdmessage。 这 样 ， 演 染 模板 时 ， 模 板 中 的 {{ boldmessage }} HAY 


字符 串 Crunchy, creamy, cookie, candy, cupcake! 。 


我 们 已 经 更 新 视图 ， 用 上 了 模板 。 现 在 启动 Django 开发 服务 器 ， 然 后 访问 hetp-//127.0.0.1:8000/ 
rango/。 你 应 该 能 看 到 这 个 简单 的 HTML 模板 泻 染 出 来 了 ， 如 图 4-1 所 示 。 
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eee [ Rango x David 


Œ | D 127.0.0.1:8000/rango/ eo nm 9 GO = 


Rango says... 


.-hey there partner! 
Crunchy, creamy, cookie, candy, cupcake! 
About 


图 4-1: 一 切 正 常 时 应 该 看 到 的 页 面 。 注 意 加 粗 的 文本 ， 即 “Crunchy, creamy, cookie, candy, 
cupcake!”， 它 们 取 自 视图 ， 通 过 模板 演 染 出 来 。 


如 果 没 看 到 上 述 页 面 ， 读 一 下 错误 消息 ， 看 看 是 什么 地 方 出 错 了 ， 再 次 确认 前 面 所 做 的 改动 。 常 
见 的 问题 之 一 是 ，settings.py 文件 中 的 模板 路 径 设 置 的 不 对 。 可 以 在 settings py 文件 中 使 用 print 
语句 输出 BASE_DIR 和 TEMPLATE_DIR 的 值 ， 确 认 一 切 是 否 正 常 。 


这 个 示例 演示 了 如 何在 视图 中 使 用 模板 。 然 而 ， 我 们 只 用 了 Django 模板 引 苟 丰富 功能 中 的 一 点 上 
毛 。 本 书后 文 还 将 使 用 更 复杂 的 模板 功能 。 如 果 想 深入 了 人 解 模板 ， 请 阅读 Django 文档 。 


4.2 伺服 静态 文件 


尽管 我 们 用 上 了 模板 ， 但 是 不 得 不 承认 ，Rango 应 用 现在 还 有 点 简陋 ， 没 有 样式 也 没有 图 像 装 
饰 。 为 了 改善 这 种 状况 ， 我 们 可 以 在 HTML 模板 中 引用 其 他 文件 ， 例 如 层 登 样式 表 (Cascading 
Style Sheet, CSS) , JavaScript 和 图 像 。 这 些 是 静态 文件 (static file) ， 因 为 它们 不 是 由 Web 服 
务 器 动态 生成 的 ， 而 是 原封 不 动 发 给 Web 浏览 器 。 本 节 说 明 Django 伺服 静态 文件 的 方式 ， 以 及 
如 何在 模板 中 添加 一 个 图 像 。 


配置 静态 文件 目录 


首先 要 指定 一 个 目录 ， 用 于 存放 静态 文件 。 在 项 目 配 置 目录 中 新 建 一 个 目录 ， 名 为 static， 然 后 在 
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static 目录 中 再 新 建 一 个 目录 ， 名 为 images, WAR static 目录 与 前 面 创建 的 templates 目录 位 于 同一 
级 。 


然后 ， 在 images 目录 中 放 一 个 图 像 。 如 下 图 所 示 ， 我 们 选择 的 是 动画 电影 《 兰 戈 》 中 变色 龙 兰 戈 
的 图 片 。 
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A 4-2: 把 变色 龙 兰 或 的 图 片 放 到 static/images 目录 中 


与 前 面 的 templates 目录 一 样 ， 我 们 要 告诉 Django 这 个 static 目录 的 路 径 。 为 此 ， 还 要 编辑 项 目的 
settings py 模块 。 在 这 个 文件 中 ， 我 们 要 定义 一 个 变量 ， 指 向 static 目录 ， 并 在 一 个 数据 结构 中 告 
诉 Django 这 个 目录 的 路 径 。 


首先 ， 在 settings py 文件 的 顶部 定义 一 个 变量 ， 名 为 STATIC_DIR。 为 了 把 所 有 路 径 放 在 一 起 ， 可 
以 把 STATIC_DIR 放 在 BASE_DIR 和 TEMPLATES_DIR 下 面 。STATIC_DIR 的 值 也 应 该 使 用 前 面 用 过 的 
os.path.jotn， 不 过 这 一 次 是 指向 static 目录 ， 如 下 所 示 : 


STATIC_DIR = os.path.join(BASE_DIR, 'static') 


这 样 得 到 的 是 一 个 绝对 路 径 ， 指 向 <workspace>/tango_with_diango_project/static/。 定 义 好 这 个 变 
量 之 后 ， 还 要 创建 一 个 数据 结构 ， 名 为 STATICFILES_DIRS。 这 个 数据 结构 的 值 是 一 系列 路 径 ， 让 
Django 在 其 中 寻找 要 伺服 的 静态 文件 。 默 认 情 况 下 ，seringspy 文件 中 没有 这 个 列表 。 在 创建 之 
前 ， 确 认 这 个 列表 确实 不 存在 。 如 果 定 义 两 次 ，Django 会 混淆 的 ， 你 自己 也 是 一 样 。 


本 书 只 在 一 个 位 置 存放 项 目的 静态 文件 ， 即 STATIC_DIR 定义 的 路 径 。 因 此 ， 我 们 可 以 像 下 面 这 样 
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设置 STATICFILES_DIRS; 


STATICFILES_DIRS = [STATIC_DIR, ] 


* 保持 settings.py 整洁 有 序 x 


最 好 保持 settings py 模块 整洁 有 序 。 不 要 随意 乱 放 ， 要 有 组 织 。 把 定义 目录 位 置 的 变量 放 在 
模块 的 顶部， 这 样 便于 查找 。 把 STATICFILES_DIRS 放 在 与 静态 文件 相关 的 那 部 分 (靠近 底 
部 ) 。 这 样 对 你 和 其 他 协作 者 来 说 都 方便 。 


最 后 ， 检 查 settings py 模块 中 有 没有 定义 STATIC_URL 变量 。 如 果 没 有 ， 像 下 面 那 样 定 义 。 注 意 ， 
Django 1.9 默认 把 这 个 变量 放 在 靠近 底部 的 位 置 ， 因 此 你 可 能 要 向 下 拉 滚 动 条 才能 找到 。 


STATIC_URL = '/static/' 


我 们 做 了 这 么 多 ， 还 没 说 为 什么 要 这 人 么 做 。 简 单 来 说 ，STATIC_DIR 和 STATICFILES_DIRS 两 个 变量 
设 定 静态 文件 在 电脑 中 的 位 置 ，STATIC_URL 变量 则 指定 启动 Django 开发 服务 器 后 通过 什么 URL 
访问 静态 文件 。 例 如 ， 把 STATIC_URL 设 为 /static/ 后 ， 我 们 可 以 通过 Attp:/127.0.0.1:8000/static/ 
访问 里 面 的 静态 内 容 。 前 两 个 变量 相当 于 服务 器 端的 位 置 ， 而 第 三 个 变量 是 客户 端 访 问 静 态 内 容 
的 位 置 。 


</> 测试 配置 


现在 ,请 测试 一 下 一 切 是 否 配 置 正确 。 启 动 Django 开发 服务 器 ， 在 浏览 器 中 访问 rango.jpg 
图 像 试 试 。 如 果 把 STATIC_URL 设 为 /static/， 而 rangojpg 的 位 置 是 images/rango.jpg， 想 一 
想 应 该 在 Web 浏览 器 中 输入 什么 URL? 


在 继续 阅读 之 前 ， 请 仔细 想 一 想 。 想 不 出 来 也 没关系 ， 后 文 会 告诉 你 。 


Al THA © 


设置 STATIC_URL 时 ， 确 保 URL 的 末尾 有 一 个 正 斜 线 (例如 ， 是 /static/， 而 不 是 
/static) 。 根 据 Django 文档 ， 缺 少 末 尾 的 和 斜 线 会 导致 一 系列 问题 。 在 末尾 加 上 和 斜 线 的 目的 
是 把 URL 的 根部 (例如 /static/) 与 要 伺服 的 静态 内 容 (例如 images/rango.jpg) 区 分 
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太 伺服 静态 内 容 x 


在 开发 环境 中 使 用 Django 开发 服务 器 伺服 静态 文件 没 问 题 ， 但 是 在 开发 环境 中 却 不 合适 。 


Django 文档 中 有 关于 在 生产 环境 中 部 署 静态 文件 的 更 多 信息 。 第 18 章 将 深入 讨论 这 个 问 
题 。 


如 果 你 没 想 出 应 该 通过 哪个 URL 访问 那个 图 像 ， 请 在 Web 浏览 器 中 输入 http-//127.0.0.1 :8000/sta- 
tic/images/rango jpg 。 


在 模板 中 引用 静态 文件 


我 们 已 经 做 好 设置 ，Django 项 目 能 处 理 静 态 文 件 了 。 现 在 可 以 在 模板 中 利用 静态 文件 改进 外 观 及 
增添 功能 


下 面 说 明 如 何 引用 静态 文件 。 打 开 <workspace>/templates/rango/ 目录 中 的 index.html 模板 ， 人 参照 
下 述 代 码 修改 。 为 了 方便 查找 ， 新 增 的 行 旁边 有 注释 。 


<!DOCTYPE htmL> 
{% load staticfiles %} <!-- 新 增 --> 


<html> 
<head> 
<title>Rango</title> 
</head> 


<body> 
<hi>Rango says...</h1> 


<div> 

hey there partner! <br /> 

<strong>{{ boldmessage }}</strong><br /> 
</div> 
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<div> 
<a href="/rango/about/">About</a><br /> 
<img src="{% static "images/rango.jpg" %}" 
alt="Picture of Rango" /> <!-- #38 --> 
</div> 
</body> 


</html> 


新 增 的 第 一 行 ({% load staticfiles %}) 告诉 Django 模板 引擎 ， 我 们 将 在 模板 中 使 用 静态 文 
件 。 这 样 便 可 以 在 模板 中 使 用 static 模板 标签 引信 静态 目录 中 的 文件 。static "images/ 

rango. jpg" 告诉 Django， 我 们 想 显示 静态 目录 中 名 为 images/rango,jpg WAR, static 标签 会 在 
images/rango.jpg 前 加 上 STATIC_URL 指定 的 URL， 得 到 /static/images/rango.jpg., Django 模板 引擎 
生成 的 HTML 如 下 : 


<img src="/static/images/rango.jpg" alt="Picture of Rango" /> 


建议 为 图 像 设 定 蔡 代 文本 ， 以 防 图 片 由 于 某 些 原因 无 法 加 载 。 蔡 代 文 本 通过 img 标签 的 alt 属性 
指定 ， 效 果 如 下 。 


Rango says... 


hey there partner! I am bold font from the context 
About Rango 
Picture of 

Rango 


图 4-3: 找 不 到 图 像 时 显示 alt 属性 的 值 


修改 视图 之 后 ， 启 动 Django 开发 服务 器 ， 然 后 访问 http:/127.0.0.1:8000/rango。 如 果 一 切 正常 ， 
应 该 会 看 到 类 似 图 4-4 中 的 网 页 。 


x 模板 中 的 <!DOCTYPE> x 


HTML 模板 的 第 一 行 始终 是 DOCTYPE 声明 。 如 果 把 {% load staticfiles %} 放 在 前 面 ， 演 染 


得 到 的 HTML F, DOCTYPE 声明 前 面 将 出 现 空白 。 多 出 的 空白 会 导致 HTML 标记 无 法 通过 验 
证 。 
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Soo/hrm xa 
€ Œ | D http://127.0.0.1:8000/rango/ 
Rango says... 

hey there partner! 


Crunchy, creamy, cookie, candy, cupcake! 
About Rango 


A 4-4: AMHRA FETÄ RELZAWA A 


太 WME BRAS x 


只 要 想 在 模板 中 引用 静态 文件 ， 就 可 以 使 用 {% static %} 模板 标签 。 下 述 代码 片段 说 明 如 何 
在 模板 中 引入 JavaScript、CSS 和 图 像 。 


<!DOCTYPE htmL> 
{% load staticfiles %} 


<html> 
<head> 
<title>Rango</title> 
ales CSS ses 
<link rel="stylesheet" href="{% static "css/base.css" %}" /> 
<!-- JavaScript --> 
<script src="{% static "js/jquery.js" %}"></script> 
</head> 
<body> 
<!-- AR --> 
<img src="{% static "images/rango.jpg" %}" alt="Picture of Rango" /> 
</body> 
</html> 
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显然 ，static 目录 中 要 有 你 引用 的 静态 文件 。 如 果 引 用 的 文件 不 存在 ， 或 者 未 正确 引用 ， 
Django 开发 服务 咒 在 控制 台中 的 输出 将 报告 HTTP 404 错误 。 你 可 以 引用 一 个 不 存在 的 文件 
试 试 。 注 意 下 述 输出 中 的 最 后 一 条 ，HTTP 状态 码 是 404。 


[10/Apr/2016 15:12:48] "GET /rango/ HTTP/1.1" 200 374 
[10/Apr/2016 15:12:48] "GET /static/images/rango.jpg HTTP/1.1" 304 0 
[10/Apr/2016 15:12:52] "GET /static/images/not-here.jpg HTTP/1.1" 404 0 


如 果 想 深入 了 解 引 入 静态 文件 的 方式 ， 请 阅读 Django 文档 。 


4.3 伺服 媒体 文件 


应 用 中 的 静态 文件 可 以 理解 为 不 变 的 文件 。 不 过 ， 有 时 还 要 使 用 可 变 的 媒体 文件 (media file) 。 
这 类 文件 可 由 用 户 或 管理 员 上 传 ， 因 此 可 能 会 变化 。 比 如 说 ， 用 户 的 头像 就 是 媒体 文件 ， 电 商 网 
站 中 的 商品 图 片 也 是 媒体 文件 。 


为 了 能 伺服 媒体 文件 ， 我 们 要 修改 Django 项 目的 设置 。 这 一 节 说 明 具 体 需 要 做 哪些 设置 ， 但 暂 不 
测试 ， 等 到 实现 用 户 上 传 头 像 功能 时 再 做 检查 。 


x 伺服 媒体 文件 六 


与 静态 文件 一 样 ， 在 Django 开发 环境 中 也 能 检查 设置 是 否 正确 。 当 然 ， 开 发 环境 中 伺服 媒 


体 文件 的 方法 极其 不 适合 在 生产 环境 中 使 用 ， 因 此 部 署 后 应 该 寻找 其 他 方式 托管 应 用 的 媒体 
文件 。 详 情 参 见 第 18 Be, 


修改 settings.py 


首先 ， 打 开 Django 项 目 配置 目录 中 的 sertings py 模块 。 我 们 将 在 这 个 文件 中 添加 一 些 内 容 。 与 静 
态 文件 一 样 ， 媒 体 文件 也 放 在 文件 系统 中 专门 的 一 个 目录 中 。 因 此 ， 要 告诉 Django 这 个 目录 的 位 
置 。 


在 settings py 模块 的 顶部 ， 找 到 BASE_DIR、TEMPLATE_DIR 和 STATIC_DIR 变量 。 在 它们 后 面 加 上 
MEDIA_DIR: 


MEDIA_DIR = os.path.join(BASE DIR, 'media') 


38 - 第 4 章 模板 和 媒体 文件 


这 一 行 告诉 Django， 媒 体 文件 将 上 传 到 Django 项 目 根 目录 中 的 media 目录 里 ， 即 <work- 
space>/tango_with_django_project/media/。 正 如 前 文 所 说 ， 把 路 径 相 关 的 变量 放 在 settings py 模块 
的 顶部 便于 以 后 修改 。 


然后 在 settings py 中 找 个 地 方 添加 两 个 变量 : MEDIA_ROOT 和 MEDIA_URL, Django 伺服 媒体 文件 时 会 
用 到 这 两 个 变量 。 


MEDIA_ROOT = MEDIA_DIR 
MEDIA_URL = '/media/' 


ott, WTR 


与 STATIC_URL 变量 一 样 ，MEDIA_URL 变量 的 末尾 要 有 一 条 正和 斜 线 ( 例 如， 是 /media/ ， 而 不 
是 /media) 。 在 末尾 加 上 和 斜 线 的 目的 是 把 URL 的 根部 (例如 /media/) 与 用 户 上 传 的 内 容 区 
分 开 。 


MEDIA_ROOT 变量 告诉 Django 在 哪里 寻找 上 传 的 媒体 文件 ，MEDIA_URL 变量 则 指明 通过 什么 URL fa] 
服 媒体 文件 。 这 样 设置 之 后 ， 上 传 的 catjpg 文件 在 Django 开发 服务 器 中 将 通过 htip://local- 
host:8000/media/cat jpg 访问 。 


后 面 在 模板 中 引入 上 传 的 内 容 时 ， 如 果 能 方便 引用 MEDIA_URL 路 径 就 好 了 。 为 了 方便 这 样 的 操 
YE, Django 提供 了 模板 上 下 文 处 理 器 。 严 格 来 说 ， 现 在 无 需 这 么 做 ， 但 是 趁机 加 上 也 没关系 。 


找到 settings py 文件 中 的 TEMPLATES FJR, EHME% context_processors 列表 。 在 
context_processors 列表 中 添加 一 个 处 理 器 ，django.tempLate.context_processors.media。 添 加 


之 后 ，context_processors 列表 应 该 类 似 下 面 这 样 : 


'context_processors': [ 
'django.template.context_processors.debug', 
'django.template.context_processors.request', 
'django.contrib.auth.context_processors.auth', 
'django.contrib.messages.context_processors.messages', 
'django.template.context_processors.media' 
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调整 URL 


在 开发 环境 中 伺服 媒体 文件 的 最 后 一 步 是 ， 让 Django 使 用 MEDIA_URL 伺服 媒体 内 容 。 打 开 项 目的 
urls py 模块 ， 修 改 urlpatterns 列表 ， 调 用 static() 函数 : 


urlpatterns = [ 


] + static(settings.MEDIA URL, document_root=settings.MEDIA ROOT) 


此 外 ， 


还 要 在 urls py 模块 的 顶部 添加 下 述 import 语句 : 


from django.conf import settings 


from django.conf.urls.static import static 


现在 可 以 通过 /media/ URL 访问 media 目录 中 的 媒体 文件 了 。 


4.4 基本 流程 


至 此 ， 


你 应 该 知道 如 何 设置 和 创建 模板 ， 知 道 如 何在 视图 中 使 用 模板 ， 知 道 如 何 设置 并 让 Django 


开发 服务 髓 伺服 静态 媒体 文件 ， 以 及 如 何在 模板 中 引入 图 像 了 。 本 章 的 知识 可 不 少 ! 


本 章 的 重点 是 知道 如 何 创 建 模 板 ， 并 在 Django 视图 中 使 用 模板 。 这 其 中 涉及 好 几 步 ， 不 过 多 做 几 
次 就 会 习惯 的 。 


© © © © 
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首先 ， 创 建 要 使 用 的 模板 ， 保 存 到 templates 目录 中 (在 项 目的 settings py 模块 中 设 定 ) 。 
模板 中 可 以 使 用 Django 模板 变量 (例如 {{ variable_name }}) 或 模板 标签 。 模 板 变 量 的 
值 在 相应 的 视图 中 设 定 。 


在 应 用 的 views py 文件 中 找到 所 需 的 视图 ， 或 者 新 建 一 个 。 
把 视图 相关 的 逻辑 写 在 视图 函数 中 。 例 如 ， 从 数据 库 中 检索 数据 ， 存 到 列表 中 。 
在 视图 中 构建 一 个 字典 ， 通 过 模板 上 下 文 传 给 模板 引擎 


使 用 render() 辅助 函数 生成 响应 。 这 个 函数 的 参数 是 请 求 对 象 、 模 板 文件 名 和 上 下 文字 
典 


F7NO 


如 果 还 没 把 视图 映射 到 URL 上 ， 修改 项 目的 wrls.py 文件 和 应 用 的 urls.py 文件 。 


在 网 页 中 引入 静态 文件 的 步骤 也 很 重要 ， 应 该 熟练 掌握 。 上 具体 方法 参见 下 述 步骤 。 
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@ 把 想 用 的 静态 文件 放 到 项 目的 static 目录 中 。 这 个 目录 在 项 目的 settings py 模块 中 的 
STATICFILES_DIRS 列表 中 设 定 。 
@ 在 模板 中 引用 静态 文件 。 例 如 ， 图 像 通过 <img /> 标签 插入 HTML 页 面 。 


© 记得 在 模板 中 加 上 {% load staticfiles %}， 然 后 使 用 {% static "<filename>" %} 标签 引 
用 静态 文件 。 把 <filename> 替换 成 图 像 或 其 他 资源 的 路 径 。 只 要 想 引 用 静态 文件 ， 使 用 
static 模板 标签 。 


伺服 媒体 文件 的 步骤 与 伺服 静态 文件 差不多 。 


@ 把 媒体 文件 放 到 项 目的 media 目录 中 。 这 个 目录 由 项 目的 settings. py 模块 中 的 MEDIA_ROOT 


N= 
变量 设 定 。 


@ 在 模板 中 使 用 {{ MEDIA_URL }} 上 下 文 变 量 引 用 媒体 文件 。 例 如 ， 引 用 上 传 的 图 像 
catjpg: <img src="{{ MEDIA_URL}}cat.jpg" />。 


</> 练习 


请 完成 以 下 练习 ， 巩 固 本 昔 所 学 的 知识 。 


让 关于 页 面 也 使 用 模板 泻 染 ， 模 板 名 为 about.html。 
在 about.html 模板 中 引入 一 个 图 片 (存储 在 项 目的 static 目录 中 ) 。 
在 关于 页 面 中 添加 一 行 : This tutorial has been put together by <your-name>.。 


在 Django 项 目 配置 目录 中 新 建 一 个 目录 ， 命 名 为 media。 从 网 上 下 载 一 张 猫 的 图 片 ， 
保存 到 media 目录 中 ， 命 名 为 cat.jpg. 

在 关于 页 面 中 添加 一 个 <img> 标签 ， 显 示 那 个 猫 的 图 片 ， 确 保 媒体 文件 能 正确 何 服 。 
加 上 首页 中 的 兰 戈 图 片 ， 现 在 你 的 应 用 既 可 以 伺服 静态 文件 ， 也 可 以 伺服 媒体 文件 。 


m| 
m) 
m) 
m) 


L! 


k 静态 文件 vs. 媒体 文件 & 


从 名 称 可 以 看 出 ， 静 态 文件 是 不 变 的 ， 是 网 站 的 核心 构成 组 件 。 而 媒体 文件 是 用 户 提供 的 ， 
时 常 变 化 。 


样式 表 是 静态 文件 ， 定 义 网 页 的 外 观 。 而 用 户 的 头像 是 媒体 文件 ， 用 户 在 注册 账户 时 上 传 。 
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模型 与 数据 库 


说 到 数据 库 ， 你 往往 会 想到 结构 化 查询 语言 (Structured Query Language, SQL) ， 这 是 从 数据 库 
中 查询 所 需 数据 的 常用 工具 。 然 而 在 Django 中 ， 查 询 底层 数据 库 这 项 操作 由 对 象 关系 映射 器 
(Object Relational Mapper, ORM) 负责 。 在 ORM 中 ， 存 储 在 一 个 数据 库 表 中 的 数据 封装 为 一 个 
模型 。 模 型 则 是 描述 数据 库 表 中 数据 的 Python 对象。Django 不 直接 通过 SQL 查询 数据 库 ， 而 是 
使 用 相应 的 Python 模型 对 象 操纵 。 


本 章 介绍 使 用 Django 及 其 ORM 管理 数据 的 基础 知识 。 你 会 发 现 ， 通 过 ORM 添加 、 修 改 和 删除 
底层 数据 库 中 的 数据 特别 简单 ， 而 且 把 数据 库 中 的 数据 检索 出 来 提供 给 Web 浏览 器 使 用 也 十 分 方 
便 。 


5.1 Rango 的 要 求 


学 习 新 知识 之 前 ， 先 回顾 一 下 Rango 应 用 对 数据 的 要 求 。 详 细 要 求 参 见 前 文 ， 这 里 只 简要 列 出 客 
户 的 要 求 。 


2 Rango 其 实 是 个 网 页 目录 ， 全 是 指向 其 他 网 站 的 链接 。 


1 网 页 有 分 类 ， 一 个 分 类 中 有 一 系列 链接 。 第 1 章 说 过 ， 我 们 假定 这 是 一 对 多 关系 ， 如 下 面 
的 实体 -关系 图 所 示 。 


J 分 类 有 名 称 ， 要 记录 查看 次 数 和 点 赞 次 数 。 
J 网 页 有 标题 和 URL， 要 记录 访问 次 数 。 
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Ea 


5.2 设置 数据 库 


创建 模型 之 前 要 设置 数据 库 。 新 建 项 目 时 ，Django 已 经 自动 在 settings.py 模块 中 添加 了 DATABASES 
变量 ， 其 值 类 似 下 面 这 样 : 


图 5-1: 两 个 主要 实体 之 间 的 ER 图 


DATABASES = { 
'default': { 
"ENGINE': 'django.db.backends.sqlite3', 
"NAME': os.path.join(BASE_DIR, 'db.sqlite3'), 


} 


对 Rango 应 用 来 说 ， 使 用 默认 值 基 本 就 行 了 。 可 以 看 到 ，default 数据 库 由 一 个 轻 量 级 数据 库 引 
擎 驱动 ， 即 SQLite (JL ENGINE 键 ) 。NAME 键 的 值 是 数据 库 文 件 的 路 径 ， 默 认为 Django 项 目 根 目 
录 中 的 db.sqlite3, 


| Git 提示 E 


如 果 你 使 用 Git， 很 可 能 想 把 数据 库 文件 纳入 版 本 控制 。 这 可 不 是 个 好 主意 ， 因 为 如 果 你 与 
别人 协作 的 话 ， 它 们 说 不 定 会 修改 数据 库 ， 这 会 导致 无 穷尽 的 冲突 。 


正确 的 做 法 是 把 db.sqlite3 添加 到 .gitignore 文件 中 ， 在 提交 和 推送 时 排除 数据 库 文件 。*pyc 
和 设备 专用 的 文件 也 应 该 忽略 。 


x 使 用 其 他 数据 库 引 擎 x 


Django 数据 库 框 架 支 持 多 种 不 同 的 数据 库 引 警 ， 例 如 PostgresSQL, MySQL 和 微软 的 SQL 
Server。 使 用 这 些 数据 库 引 警 时 ， 可 以 使 用 USER, PASSWORD, HOST 和 PORT 等 键 配 置 。 
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本 书 不 说 明 如 何 使 用 其 他 数据 库 引 擎 ， 如 果 想 了 解 这 方面 的 知识 ， 请 到 网 上 得 找 资源 。 可 以 
从 Django 文档 开始 。 


SQLite 足够 说 明 Django ORM 的 功能 了 。 如 果 你 的 应 用 大 受 欢迎 、 流 量 激增 ， 或 许 应 该 考虑 
换 用 更 可 靠 的 数据 库 后 端 。 


5.3 创建 模型 


在 settings py 模块 中 配置 好 数据 库 之 后 ， 下 面 创建 Rango 应 用 所 需 的 两 个 数据 模型 。Django 应 用 
的 模型 保存 在 应 用 目录 中 的 models py 模块 里 。 因 此 ，Rango 应 用 的 模型 保存 在 rango/models py 
文件 中 。 


我 们 要 定义 两 个 类 ， 一 个 类 对 应 一 个 模型 。 这 两 个 类 都 要 继承 基 类 django.db.modeLs.ModeL， 分 
别 表示 分 类 和 网 页 。 参 上 照 下 述 代 码 片 段 定义 Category 和 Page 模型 。 


class Category(models.Model): 
name = models.CharField(max_length=128, unique=True) 


def _str__(self): # Python 2 还 要 定义 unicode _ 
return self.name 


class Page(models.Model): 
category = models.ForeignKey(Category) 
title = models.CharField(max_length=128) 
url = models.URLField() 
views = models. IntegerField(defauLt=0) 


def _str__ (self): # Python 2 还 要 定义 __unicode__ 
return self.title 


E 检查 import 语句 m 


models py 模块 的 顶部 应 该 有 from django.db import models。 如 果 没 有 ， 自 己 动 手 加 上 。 
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* __str__() vS. __unicode__() * 


在 Python 中 ，__str_() 和 __unicode_() 方 法 生成 类 的 字符 串 表示 形式 (类似 于 Java 中 的 
toString() 方法) 。 在 Python 2x 中 ，__str_() 方 法 以 ASCII 格式 表示 字符 串 ， 如 果 需 要 


支持 Unicode, WEM unicode__() 方法 。 


在 Python 3.x 中 ， 字 符 串 默认 就 支持 Unicode， 因 此 只 需 实 现 str O 方法 。 


定义 模型 时 ， 要 指定 字段 及 其 类 型 ， 并 提供 必须 或 可 选 的 参数 。 默 认 情 况 下 ， 每 个 模型 都 有 一 个 
自 增 整数 字段 ， 名 为 id。 这 个 字段 自动 分 配 ， 用 作 主 键 。 


Django 内 置 的 字段 类 型 无 所 不 包 。 下 面 介绍 其 中 最 常用 的 几 个 : 
“J CharFieLd: 存储 字符 数据 (如 字符 串 ) 的 字段 。max_length 参数 指定 最 多 可 存储 的 字符 
数 。 
d URLField: 类 似 于 CharFieLd， 不 过 是 专用 于 存储 URL 的 。 也 可 指定 max_length 参数 。 
中 IntegerField: 存储 整数 。 


DJ DateFieLd: 存储 Python datetime.date 对 象 。 


太 其 他 字段 类 型 x 


Django 提供 的 全 部 字段 类 型 ， 以 及 各 自 必 须 和 可 选 的 参数 说 明 ， 参 见 Django 文档 。 


每 个 字段 都 可 指定 unique 参数 ， 设 为 True 时 ， 字 段 的 值 在 模型 对 应 的 底层 数据 库 表 中 必须 是 唯 
一 的 。 看 一 下 前 面 定 义 的 Category 模型 。name 字段 设 为 唯一 的 了 ， 这 表明 每 个 分 类 的 名 称 必 须 是 
唯一 的 。 这 也 意味 着 ， 可 以 把 name 字段 用 作 主 键 。 


此 外 ， 各 字段 还 可 指定 其 他 参数 ， 例 如 通过 default='value' 设 定 默认 值 ， 指 定 字段 的 值 可 以 为 
室 (nuLL=True) 或 者 不 可 以 为 空 (null=False) 。 


为 了 建立 模型 之 间 的 关系 ，Django 提供 了 三 个 字段 类 型 ， 分 别 是 : 


I Foreignkey: 用 于 建立 一 对 多 关系 。 
L] OneToOneField: 用 于 建立 一 对 一 关系 。 


口 ManyToManyField: 用 于 建立 多 对 多 关系 。 
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在 我 们 定义 的 模型 中 ，Page 模型 中 的 category 字段 是 Foreignkey 类 型 。 我 们 在 字段 的 构造 方法 
中 指定 ， 与 Category 模型 建立 一 对 多 关系 。 


最 后 ， 建 议 实现 _str _() 和 (或 ) __unicode_() 方法 。 如 果 不 实现 ， 使 用 print 打印 对 象 时 将 
显示 <Category: Category object>， 这 对 调试 没什么 帮助 ， 如 果实 现 的 话 ， 打 印 “Python” 分 类 时 
将 显示 <Category: Python>。 这 两 个 方法 在 管理 界面 中 也 用 得 到 ， 因 为 Django 会 在 管理 后 台中 显 
示 对 象 的 字符 串 表 示 形 式 。 


5.4 创建 和 迁移 数据 库 


在 models py 中 定义 好 模型 之 后 ， 可 以 让 Django 施展 魔法 ， 在 底层 数据 库 中 创建 表 了 。 为 此 ， 
Django 提供 了 迁移 工具 ， 让 它 帮 助 我 们 设置 和 更 新 数据 库 ， 体 现 模型 的 改动 。 例 如 ， 添 加 新 字段 
后 可 以 使 用 迁移 工具 更 新 数据 库 。 


设置 


首先 ， 数 据 库 必 须 预 置 ， 即 创建 数据 库 及 相关 的 表 。 请 打开 终端 或 命令 提示 符 ， 进 入 项 目的 根 目 
录 (manage py 文件 所 在 的 目录 ) ， 执 行 下 述 命 令 。 注 意 ， 你 看 到 的 输出 可 能 与 这 里 不 一 样 。 


$ python manage.py migrate 


Operations to perform: 
Apply all migrations: admin, contenttypes, auth, sessions 
Running migrations: 
Rendering model states... DONE 
Applying contenttypes.0001 initial... OK 
Applying auth.0001_ initial... OK 
Applying admin.0001_initial... OK 
Applying admin.0002_logentry_remove_auto_add... OK 
Applying contenttypes.0002_remove_content_type_name... OK 
Applying auth.0002_alter_permission_name_max_length... OK 
Applying auth.0003 alter_user_email_max_length... OK 
Applying auth.0004_alter_user_username_opts... OK 
Applying auth.0005_alter_user_Last_Login_null... OK 
Applying auth.0006_require_contenttypes_ 0002... OK 
Applying auth.0007_alter_validators_add_error_messages... OK 
Applying sessions.0001_initial... OK 
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执行 这 个 命令 后 ， 项 目 中 安装 的 所 有 应 用 都 会 更 新 各 自 的 数据 库 表 。 这 个 命令 执行 完毕 后 ，Djan- 
go 项 目的 根 目录 中 会 出 现 db.sqlite3 文件 。 


然后 ， 创 建 一 个 超级 用 户 (superuser) ， 用 于 管理 数据 库 。 执 行 下 述 命令 : 


$ python manage.py createsuperuser 


这 个 超级 用 户 在 本 章 后 面 将 用 于 访问 Django 管理 界面 。 请 根据 提示 输入 用 户 名 、 电 子 邮 件 地 址 和 
密码 。 别 饼 了 记 下 超级 用 户 的 用 户 名 和 密码 。 


创建 和 更 新 模型 / 表 


每 次 修改 应 用 的 模型 都 要 通过 manage py 中 的 makemigrations 命令 登记 改动 。 在 Django 项 目的 根 
目录 中 执行 下 述 命 令 ， 指 明 目 标 为 rango 应 用 : 


$ python manage.py makemigrations rango 


Migrations for 'rango': 
0001_initial.py: 
- Create model Category 
- Create model Page 


上 述 命令 执行 完毕 后 ，rango/migrations 目录 中 会 出 现 一 个 Python 脚本 ， 名 为 0001 _initial py, X 
个 脚本 中 包含 此 次 迁移 创建 数据 库 模 式 所 需 的 一 切 信息 。 


* 检查 底层 SQL * 


如 果 想 查看 Django ORM 为 某 个 迁移 执行 的 底层 SQL， 可 以 执行 下 述 命令 : 


$ python manage.py sqlmigrate rango 0001 


这 里 ，rango 是 应 用 的 名 称 ，0001 是 想 查 看 SQL 代码 的 迁移 。 这 样 做 能 更 好 地 理解 数据 库 层 
具体 做 了 哪些 操作 ， 例 如 创建 了 什么 表 。 你 可 能 会 发 现 其 中 包含 复杂 的 数据 库 模 式 ， 比 如 建 
并 多 对 多 关系 时 会 创建 额外 的 表 。 


创建 好 迁移 后 ， 要 提交 到 数据 库 。 为 此 要 再 次 执行 migrate 命令 。 


$ python manage.py migrate 
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Operations to perform: 

Apply all migrations: admin, rango, contenttypes, auth, sessions 
Running migrations: 

Rendering model states... DONE 

Applying rango.0001_initial... OK 


输出 表明 在 数据 库 中 创建 了 所 需 的 表 。 


不 过 ， 你 可 能 注意 到 了 ， 根 据 客户 对 Rango 提出 的 要 求 ，Category 模型 还 缺少 一 些 字 段 。 


心 ， 后 面 会 再 次 通过 迁移 加 上 。 


5.5 Django 模型 和 shell 


别 担 


暂 不 介绍 Django 管理 界面 ， 先 来 看 看 Django shell。 这 个 工具 对 调试 十 分 有 用 ， 可 以 直接 与 Djan- 


go 模型 交互 。 下 面 说 明 如 何在 shell 中 创建 Category 实例 。 


为 了 打开 shell， 我 们 要 再 次 在 项 目的 根 目录 中 运行 manage.py 脚本 。 执 行 下 述 命令 : 


$ python manage.py shell 


这 个 命令 启动 Python 解释 器 ， 并 加 载 项 目的 设置 。 在 这 个 shell 中 可 以 与 模型 交互 ， 具 体 方法 参 
见 下 述 终端 会 话 中 的 演示 。 留 意 笔 者 加 上 的 注释 ， 了 解 各 命令 的 作用 。 注 意 ，Django 1.9 和 1.10 


返回 的 结果 稍 有 不 同 ， 下 述 示 侈 都 给 出 了 ， 并 在 注释 中 做 了 说 明 。 


# 从 Rango 应 用 中 导入 Category 模型 
>>> from rango.models import Category 


# 显示 目前 的 所 有 分 类 

>>> print(Category.objects.all()) 

# 下 述 输出 分 别针 对 Django 1.9 和 Django 1.10 

# 意思 是 一 样 的 ， 都 表示 还 未 定义 分 类 

[] # Django 1.9 的 输出 : 一 个 空 列 表 

<QuerySet []> # Django 1.10 的 输出 : 一 个 空 QuerySet 对 象 


# 创建 一 个 分 类 对 象 ， 存 入 数据 库 
>>> cC = Category(name="Test") 


>>> C.Save() 


# 再 次 列 出 所 有 分 类 对 象 
>>> print(Category.objects.all()) 
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# 下 述 输出 分 别针 对 Django 1.9 和 Django 1.10 
# 两 个 输出 中 都 有 测试 分 类 

[<Category: Test>] # Django 1.9 

<QuerySet [<Category: Test>] # Django 1.10 


# 退出 Django shell 
>>> quit() 


这 里 ， 我 们 先导 和 人 要 操纵 的 模型 。 然 后 打印 现 有 的 全 部 分 类 。 因 为 底层 的 category 表 是 空 的 ， 所 
以 返回 一 个 空 列表 。 之 后 ， 我 们 创建 并 保存 了 一 个 Category 对 象 ， 然 后 再 次 打印 所 有 分 类 。 这 一 
次 打印 发 现 有 个 新 分 类 。 注 意 ， 第 二 次 打印 显示 了 分 类 的 名 称 ， 这 是 _str_() BK __unicode__() 
方法 的 功劳 。 


</> 阅读 官方 教程 
以 上 只 是 简单 演示 ， 除 此 之 外 ， 在 Django shell 中 可 以 执行 的 操作 还 有 很 多 。 如 果 你 还 没 阅 


读 Django 官方 教程 的 第 二 部 分 ， 现 在 是 个 好 时 机 ， 请 留意 在 shell 中 与 模型 交互 的 更 多 方 
法 。 顺 便 看 一 下 Django 文档 中 列 出 的 模型 操作 命令 。 


5.6 配置 管理 界面 


Django 广 受 欢迎 的 一 个 功能 是 内 置 的 Web 管理 界面 ， 在 这 里 你 可 以 浏览 、 标 记 和 删除 模型 实例 
表示 的 数据 。 本 市 将 做 些 设置 ， 让 你 在 管理 界面 中 查看 Rango 应 用 的 两 个 模型 。 


相关 的 设置 很 简单 。 在 项 目的 settings py 模块 中 你 可 能 注意 到 了 ， 有 个 预 装 的 应 用 是 
django.contrib.admin (在 INSTALLED_APPS 列表 中 ) 。 此 外 ， 在 项 目的 wris.py 模块 中 有 个 匹配 
admin/ 的 URL 模式 (FE urlpattern 中 ) 。 


其 实 ， 使 用 默认 的 设置 基本 就 行 了 。 执 行 下 述 命令 ， 启 动 Django 开发 服务 器 : 
$ python manage.py runserver 


然后 打开 Web 浏览 器 ， 访 问 http:1/127.0.0.1:8000/admin/。 你 会 看 到 登录 界面 。 使 用 创建 超级 用 户 
时 提供 的 凭据 登录 。 登 录 后 会 看 到 类 似 图 5-2 所 示 的 界面 。 
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© @ |B Site administration | Djang: x \ a | David | 
€ > @ [D 127.0.0.1:8000/admin/ B90 


WELCOME, DAVID. VIEW SITE / CHANGE PASSWORD / LOG OUT 


Site administration 


Recent Actions 


Groups 二 Add = # Change 
Users 十 Add # Change My Actions 


None available 


$e! c___—_—~ 


图 5-2: Django 管理 界面 ， 没 有 Rango 应 用 的 模型 
看 起 来 不 错 ， 但 是 没有 Rango 应 用 的 Category 和 Page 模型 。 为 了 显示 这 两 个 模型 ， 我 们 要 给 
Django 一 些 提 示 。 


打开 rango/admin py 文件 ， 注 册 想 在 管理 界面 显示 的 类 。 下 述 代 码 注册 Category 和 Page 两 个 
类 。 


from django.contrib import admin 
from rango.models import Category, Page 


admin.site.register(Category) 
admin.site.register (Page) 


如 果 以 后 添加 更 多 模型 ， 只 需 再 调用 admin. site.register() 方法。 


改 好 之 后 ， 重 启 Django 开发 服务 器 ， 然 后 再 次 访问 http://127.0.0.1:8000/admin/。 现 在 能 看 到 
Category 和 Page 模型 了 ， 如 图 5-3 所 示 。 
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eco [ Site administration | Djang x David 


€ > @ [5 127.0.0.1:8000/admin/ 


WELCOME, DAVID. VIEW SITE / CHANGE PASSWORD / LOG OUT 


Site administration 


AUTHENTICATION AND AUTHORIZATION A 
Recent Actions 
Groups +Add = # Change 
Users +Add Æ Change My Actions 
None available 
Categorys +Add = # Change 


+Add = # Change 


图 5-3: Django 管理 界面 中 显示 了 Rango 应 用 的 模型 


mih Rango” X FAY Categorys 链接 试 试 。 你 应 该 会 看 到 前 面 在 Django shell 中 创建 的 Test 分 类 。 


</> 熟悉 管理 界面 


在 开发 Rango 应 用 的 过 程 中 我 们 会 经 常 在 管理 界面 中 确认 数据 有 没有 正确 存储 ， 因 此 请 花 点 
时 间 熟 悉 一 下 管理 界面 。 


把 前 面 创 建 的 Test 分 类 删除 。 稍 后 会 向 数据 库 中 填充 更 多 示例 数据 。 


x 用户 管理 x 


用 户 也 在 Django 管理 界面 中 管理 ， 在 "Authentication and Authorisation”* 区 。 你 可 以 创建 、 修 
改 和 删除 用 户 账户 ， 还 可 以 赋予 用 户 不 同 的 权限 等 级 。 


发 现 没 有 ， 管 理 界面 中 有 拼写 错误 (应 该 是 Categories， 而 不 是 Categorys) ? 为 了 修正 这 
个 错误 ， 可 以 在 模型 定义 中 添加 般 套 的 Meta 类 ， 在 里 面 声明 verbose_name_plural 属性 。 下 
面 是 修改 后 的 Category 模型 。Meta 类 有 很 多 作用 ， 详 情 参 见 Django 文档 。 
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class Category(models.Model): 
name = models.CharField(max_length=128, unique=True) 


class Meta: 
verbose_name_plural = 'Categories' 


def __str_ (self): 
return self.name 


* 丰富 admin.py 的 内 容 * 


不 难看 出 ，admin.py 差不多 是 Rango 应 用 中 内 容 最 少 的 模块 。 其 实 ， 在 这 个 模块 中 能 以 多 种 


方式 定制 管理 界面 。 如 果 感 兴趣 ， 请 阅读 Django 文档 。 


5.7 编写 一 个 填充 脚本 


把 测试 数据 输入 数据 库 是 件 麻 烦 事 。 很 多 开发 者 选择 随机 按键 ， 输 入 虚假 的 测试 数据 ， 例 如 
wTFzmN99bz7。 与 其 这 样 ， 不 如 编写 一 个 脚本 ， 把 真实 可 信 的 数据 自动 填充 到 数据 库 中 。 如 此 一 
来 ， 演 示 或 测试 应 用 时 ， 你 将 看 到 合理 的 示例 。 而 且 ， 部 署 应 用 或 者 与 同事 分 享 时 ， 你 自己 和 同 
事 无 需 自 己 动 手 输入 示例 数据 。 鉴 于 此 ， 最 好 编写 一 个 填充 脚本 。 


下 面 为 Rango 应 用 编写 一 个 填充 脚本 。 在 Django 项 目的 根 目录 中 新 建 一 个 Python 文件 ， 命 名 为 
populate_rango.py， 写 入 下 述 代码 : 


import os 
os.environ.setdefauLlt('DJANGO_SETTINGS MODULE', 


'tango_with_django_project.settings') 


import django 
django.setup() 
from rango.models import Category, Page 


\D ON DMN BW NB 


def populate(): 

10 # 首先 创建 一 些 字典 ， 列 出 想 添加 到 各 分 类 的 网 页 

11 # 然后 创建 一 个 嵌 套 字典 ， 设 置 各 分 类 

12 # 这 么 做 看 起 来 不 易 理解 ， 但 是 便于 选 代 ， 方 便 为 模型 添加 数据 
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13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 


python_pages = [ 
{"title": "Official Python Tutorial", 
"url":"http://docs.python.org/2/tutorial/"}, 
{"title":"How to Think like a Computer Scientist", 
"url":"http://www.greenteapress.com/thinkpython/"}, 
{"title":"Learn Python in 10 Minutes", 
"url":"http://www.korokithakis.net/tutorials/python/"} ] 


django_pages = [ 
{"title":"Official Django Tutorial", 
"url":"https://docs.djangoproject.com/en/1.9/intro/tutorial01/"}, 
{"title":"Django Rocks", 
"url":"http: //www.djangorocks.com/"}, 
{"title":"How to Tango with Django", 
"url":"http: //www.tangowithdjango.com/"} ] 


other_pages = [ 
{"title":"Bottle", 
"url":"http://bottlepy.org/docs/dev/"}, 
{"title":"Flask", 
"url":"http://flask.pocoo.org"} ] 


cats = {"Python": {"pages": python_pages}, 
"Django": {"pages": django_pages}, 
"Other Frameworks": {"pages": other_pages} } 


# 如 果 想 添加 更 多 分 类 或 网 页 ， 添 加 到 前 面 的 字典 中 即 可 


河 


# 下 述 代码 和 迭代 cats 字典 ,添加 各 分 类 ， 并 把 相关 的 网 页 添加 到 分 类 中 
# 如 果 使 用 的 是 Python 2.x, 要 使 用 cats.iteritems() 34% 

E 迁 代 字典 的 正确 方式 参见 

# http://docs.quantifiedcode.com/python-anti-patterns/readability/ 


for cat, cat_data in cats.items(): 
c = add_cat(cat) 
for p in cat_data["pages"]: 
add_page(c, p["title"], p["url"]) 
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# 打印 添加 的 分 类 
for c in Category.objects.all(): 
for p in Page.objects.filter(category=c): 
print("- {0} - {1}".format(str(c), str(p))) 


def add_page(cat, title, url, views=0): 
p = Page.objects.get_or_create(category=cat, title=title)[0] 
p.url=url 
p.views=views 
p.save() 


return p 


def add_cat(name): 
c = Category.objects.get_or_create(name=name) [0] 
c.save() 


return c 


# 从 这 开始 执行 

if _ name == ' main_': 
print("Starting Rango population script...") 
populate() 


E 充分 理解 代码 m 


再 次 说 明 ， 不 要 直接 复制 粘贴 代码 ， 然 后 就 不 管 了 。 把 代码 添加 到 模块 中 之 后 ， 逐 行 分 析 一 
下 ， 要 理解 各 行 的 作用 。 


下 面 给 出 说 明 , 希望 你 能 从 中 学 到 新 知识 。 


你 可 能 注意 到 了 ， 上 述 代 码 有 行 号 。 这 表示 给 出 的 是 整个 文件 的 代码 ， 而 不 是 代码 片段 。 带 
行 号 的 代码 更 难 复 制 。 


看 着 代码 很 多 ， 其 实 就 是 对 模块 后 部 定义 的 add_page() 和 add_cat() 两 个 函数 的 调用 。 上 述 代码 
从 模块 的 底部 开始 执行 ， 即 第 71 和 72 行 。 这 是 因为 在 此 之 前 是 函数 定义 ， 并 未 调用 ， 因 此 也 就 
未 执行 。 解 释 器 遇 到 第 70 行 的 if _nane == '__main__' 时 调用 populate() 函数 。 
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E _name_ == 


__name__ == '_main__' 是 个 有 用 的 技巧 ， 既 让 Python 模块 作为 可 重用 的 模块 ， 也 让 其 作为 
独立 的 Python 脚本 。 可 重用 的 模块 是 指 可 以 导 人 其 他 模块 〈 例 如 通过 import 语句 ) ， 而 独 
立 的 Python 脚本 可 以 在 终端 或 命令 提示 符 中 执行 (python module.py) 。 


因此 ，if _mame_ == '_main_' 条 件 语 句 中 的 代码 仅 在 作为 独立 的 Python 脚本 运行 时 才 
执行 。 如 果 作 为 模块 导入 ， 那 一 段 代码 不 执行 ， 因 为 导入 做 是 为 了 访问 模块 中 的 类 或 函数 。 


© 导入 模型 + 


SA Django 模型 之 前 要 导入 django， 并 把 环境 变量 DIANGO_SETTINGS MODULE 设 为 项 目的 设 
置 文件 ， 然 后 调用 django.setup(), A Django 项 目的 设置 (第 1-6 行 ) 。 


如 果 缺 少 这 重要 的 一 步 ， 导 和 人 模型 时 会 抛 出 异常 ， 这 是 因为 所 需 的 Django 基础 设施 未 初始 
化 。 鉴 于 此 ， 我 们 在 第 7 行 才 导 入 Category 和 Page 模型 。 


第 47-50 行 的 for 循环 负责 不 断 调 用 add_cat() 和 add_page() 函数 。 这 两 个 函数 的 作用 分 别 是 创 
建 分 类 和 网 页 。populate() 函数 会 记录 创建 了 哪些 分 类 。 我 们 在 第 48 行 把 分 类 存储 在 局 部 变量 c 
中 ， 因 为 创建 Page 对 象 时 要 引用 Category 对 象 。 调 用 add_cat() 和 add_page() 函数 后 ， 
populate() 迭代 所 有 Category 和 相应 的 Page 对 象 ， 把 它们 的 名 称 显 示 在 终端 中 。 


太 创建 模型 实例 太 


在 上 述 填充 脚本 中 ， 我 们 使 用 便利 的 get_or_create() 方法 创建 模型 实例 。 由 于 我 们 不 想 创 
建 重复 的 记录 ， 因 此 使 用 get_or_create() 方法 检查 数据 库 中 有 没有 要 创建 的 记录 ; 如 果 没 
有 ， 创 建 指 定 的 记录 ; 否则 ， 返 回 那个 模型 实例 的 引用 。 


这 个 辅助 方法 能 避免 我 们 编写 大 量 重复 的 代码 。 既 然 有 这 样 的 方法 存在 ， 何 必 自 己 动手 检查 
呢 | 


get_or_create() 方法 返回 一 个 元 组 (object，created)。 第 一 个 元 素 是 数据 库 中 不 存在 记录 

时 创建 的 模型 实例 引用 。 这 个 模型 实例 使 用 传 给 get_or_create() 方法 的 参数 创建 ， 例 如 上 

例 中 的 category, title, url 和 views。 如 果 数 据 库 中 存在 相应 的 记录 ，get_or_create() 方 
法 返回 那个 记录 。created 是 布尔 值 ，get_or_create() 创建 模型 实例 时 值 为 True, 


了 解 这 些 之 后 我 们 便 知 道 get_or_create() 后 面 的 [9] 表示 只 返回 对 象 引 用 。 与 很 多 其 他 编 
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程 语言 数据 结构 一 样 ，Python 元 组 中 的 元 素 从 零 开始 编号 。 


get_or_create() 方法 的 更 多 信息 参见 Django 文档 。 


保存 文件 ， 在 终端 把 当前 工作 目录 切换 到 Django 项 目的 根 目 录 ， 然 后 执行 python 
populate_rango.py 命令 。 你 应 该 会 看 到 类 似 下 面 的 输出 ， 在 不 同 的 电脑 中 添加 分 类 的 顺序 可 能 有 


所 不 同 。 


$ python populate_rango.py 


Starting Rango population script... 


- Python 


- Django - 
- Django - 


- Official Python Tutorial 
- Python - 
- Python - 
- Django - 


How to Think like a Computer Scientist 
Learn Python in 10 Minutes 

Official Django Tutorial 

Django Rocks 

How to Tango with Django 


- Other Frameworks - Bottle 


- Other Frameworks - Flask 


然后 ， 确 认 填 充 脚 本 确实 把 数据 填充 进 数 据 库 中 了 。 重 启 Django 开发 服务 器 ， 访 问 管理 界面 
(http://127.0.0.1:8000/admin/) ， 检 查 有 没有 新 的 分 类 和 网 页 出 现 。 点 击 “Pages”"， 有 没有 看 到 所 
有 网 页 ， 如 下 图 所 示 ? 


编写 填充 脚本 要 花 点 时 间 ， 但 从 长 远 来 看 ， 最 终 是 能 节省 时 间 的 。 把 应 用 部 署 到 其 他 地 方 ， 只 需 
运行 填充 脚本 就 能 立即 演示 ， 这 样 多 方便 。 单 元 测试 也 能 用 到 填充 脚本 (参见 第 17 Es) 。 
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@ © @ / Py select page to change | D; x \ i David 
€ > CC [5 127.0.0.1:8000/admin/rango/page/ 


WELCOME, DAVID. VIEW SITE / CHANGE PASSWORD / LOG OUT 


Home> Rango » Pages 


Select page to change 
Action: -+------- || Go | 0of8 selected 
C] PAGE 
O Flask 
O Bottle 
CO How to Tango with Django 
© Django Rocks 


© Official Django Tutorial 
© Leam Python in 10 Minutes 
O How to Think like a Computer Scientist 


© Official Python Tutorial 


8 pages 


图 5-4: Django 管理 页 面 中 显示 着 填充 脚本 添加 的 网 页 


5.8 基本 流程 

我 们 已 经 学 习 了 Django ORM 的 核心 概念 ， 现 在 是 时 候 总 结 一 下 了 。 为 了 便于 参考 ， 笔 者 把 整个 
过 程 分 成 了 几 部 分 。 如 果 以 后 你 想 回 顾 这 个 过 程 ， 可 以 随时 翻阅 这 一 节 。 

设置 数据 库 


新 建 项 目 后 应 该 告诉 Django 你 想 用 什么 数据 库 (settings py 模块 中 的 DATABASES 设置 ) 。 此 外 ， 
还 可 以 在 admin py 模块 中 注册 模型 ， 以 便 在 管理 界面 中 管理 。 


添加 模型 

添加 模型 的 过 程 可 以 分 为 以 下 5 步 。 
@ 首先 在 Django 应 用 的 models py 文件 中 定义 模型 。 
@ 更 新 adminpy， 注 册 新 增 的 模型 。 


© 生成 迁移 : python manage.py makemigrations <app_name>。 
@ 运行 迁移 : python manage.py mtgrate。 在 数据 库 中 创建 模型 所 需 的 表 和 字段 。 
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© 


创建 或 编辑 填充 脚本 。 


有 时 你 可 能 想 删 除数 据 库 ， 重 头 再 来 。 具 体 步骤 如 下 。 注 意 ， 本 书 使 用 的 是 SQLite 数据 库 ， 此 外 
Django 还 支持 其 他 数据 库 引 擎 。 


0 
(27 


如 果 Django 开发 服务 器 正在 运行 ， 停 止 。 


如 果 使 用 的 是 SQLite 数据 库 ， 删 除 Django 项 目 根 目录 中 的 db.sqlite3 文件 。 这 个 文件 与 
manage py 脚本 位 于 同一 级 目录 中 。 


如 果 修 改过 应 用 的 模型 ， 执 行 python manage.py makemigrations <app_name> 命令 ， 记 得 把 
<app_name> 替换 成 Django 应 用 的 名 称 〈 例 如 rango。) 如 果 未 修改 模型 ， 跳 过 这 一 步 。 


HUE python manage.py migrate 命令 ， 新 建 数 据 库 文件 (使 用 SQLite 的 话 ) ， 并 创建 数据 
库 表 。 


执行 python manage.py createsuperuser 命令 ,创建 一 个 超级 用 户 。 


最 后 ， 运 行 填充 脚本 ， 在 新 数据 库 中 插入 可 信 的 测试 数据 。 


</> 练习 


请 完成 以 下 练习 ， 巩 固 本 章 所 学 的 知识 。 再 次 提醒 ， 后 续 章节 建立 在 这 些 练习 之 上 ， 请 务必 
完成 。 如 果 卡 住 了 ， 请 看 后 面 的 提示 。 


J 更 新 Category 模型 ， 加 上 views 和 likes 字段 ， 二 者 的 默认 值 均 是 零 。 
J 创建 迁移 ， 然 后 执行 ， 提 交 此 次 改动 。 
J 更 新 填充 脚本 ， 把 “Python 分 类 的 查看 次 数 设 为 128、 点 赞 次 数 设 为 64， 把 “Django” 


分 类 的 查看 次 数 设 为 64、 点 赞 次 数 设 为 32， 把 “Other Frameworks” 分 类 的 查看 次 数 设 
为 32、 点 赞 次 数 设 为 16。 


2 删除 数据 库 ， 然 后 重新 创建 ， 再 使 用 填充 脚本 填充 数据 。 
J 阅读 Django 官方 教程 的 第 二 部 分 和 第 七 部 分 。 这 两 部 分 能 巩 国 本 章 所 学 的 数据 库 处 理 


知识 ， 还 涉及 一 些 定 制 Django 管理 界面 的 技术 。 


J 定制 管理 界面 ， 访 问 Page 模型 时 显示 网 页 的 分 类 、 名 称 和 URL， 就 像 图 5-5 那样 。 你 


要 做 完 前 一 题 才 知道 怎么 解答 这 一 题 。 
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@ @ @ /Mh Select page to change | Di: x David 


€ > @ [ 127.0.0.1:8000/admin/rango/page/ 
WELCOME, DAVID. VIEW SITE / CHANGE PASSWORD / LOG OUT 
Home > Rango » Pages 
Select page to change 
Action: -+------- || Go | Oof 8 selected 
Q TITLE CATEGORY URL 
O Flask Other Frameworks http://flask.pocoo.org 
O Bottle Other Frameworks http://bottlepy.org/docs/dev/ 
O How to Tango with Django Django http://www.tangowithdjango.com/ 
O Django Rocks Django http://www.djangorocks.com/ 
O Official Django Tutorial Django https://docs.djangoproject.com/en/1.5/intro/tutorial01/ 
© Leam Python in 10 Minutes Python http://www.korokithakis.net/tutorials/python/ 
O How to Think like a Computer Scientist Python http://www.greenteapress.com/thinkpython/ 
Q Official Python Tutorial Python http://docs.python.org/2/tutorial/ 
8 pages 


图 5-5: 更 新 后 的 管理 界面 ，Page 模型 页 面 显 示 有 网 页 的 分 类 和 URL 


如 果 你 做 不 出 上 述 练习 ， 和 希望 下 面 的 提示 能 给 你 一 点 启发 。 


d 修改 Category 模型 ， 添 加 两 个 IntegerField: views 和 likes, 
O 修改 填充 脚本 中 的 add_cat() 函数 ， 让 它 能 处 理 Category 模型 新 增 的 views 和 Likes 


字段 。 


。 除了 name 参数 之 外 ， 为 add_cat() 函数 增加 两 个 参数 ， 以 便 传人 views 和 Likes 
的 值 。 


。 在 add_cat() 函数 中 使 用 这 两 个 参数 设置 Category 模型 实例 的 views 和 Likes = 
段 。 在 填充 脚本 中 ， 分 类 对 象 赋值 给 变量 c， 因 此 可 以 通过 c.Likes 访问 likes = 
段 。 别 忘 了 调用 save()， 保 存 实例 。 

。 然后 更 新 填充 脚本 中 populate() 函数 里 的 cats 字典 。 这 个 字典 中 的 元 素 ， 键 是 分 


类 的 名 称 ， 值 也 是 一 个 字典 ， 包 含 分 类 的 信息 。 要 修改 的 是 这 个 内 部 的 字典 ， 为 
各 分 类 添加 views 和 likes, 
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。 最 后 ， 修 改 调用 add_cat() 函数 的 方式 。 现 在 要 传人 三 个 参数 (name, views 和 
likes) ， 而 目前 只 传人 了 name。 要 在 函数 调用 中 添加 那 两 个 参数 。 如 果 不 知道 如 
何 使 用 for 循环 迭代 字典 ， 请 阅读 这 个 在 线 Python 教程 。 读 完 之 后 你 便 知道 如 何 
访问 字典 中 的 views 和 likes 值 。 


DJ 更 新 填充 脚本 之 后 ， 定 制 管理 界面 。 要 编辑 rango/admin.py 文件 ， 定 义 PageAdmin 
类 ， 继 承 自 admin.ModelAdmin, 


。 在 新 增 的 PageAdmin 类 中 添加 list_display = ('title', 'category', 'url'), 


。 然后 注册 PageAdmin 类 。 要 修改 Rango 应 用 的 admin.py 文件 ， 把 


admin.site.register(Page) PAK admin.site.register(Page，PageAdmin) 。 


太 测试 x 


笔者 编写 了 几 个 测试 ， 检 查 你 有 没有 做 完 练习 。 从 本 书 的 GitHub 仓库 中 下 载 tesispy 脚本 ， 
保存 到 Rango 应 用 目录 中 。 


然后 在 终端 或 命令 提示 符 中 执行 下 述 命令 ， 运 行 测试 : 


$ python manage.py test rango 


如 果 你 对 自动 化 测试 感 兴趣 ， 可 以 翻 到 第 17 音 。 那 一 章 将 介绍 一 些 基本 的 测试 知识 ， 以 便 
自动 检查 代码 的 完整 性 。 
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图 灵 社 区 会 员 BRAE2018(wusijing2018@163.com) FS 尊重 版 权 


模型 、 模 板 和 视图 


现在 ， 我 们 定义 了 两 个 模型 ， 还 在 数据 库 中 填充 了 一 些 示例 数据 ， 接 下 来 可 以 连接 模型 、 视 图 和 
模板 ， 何 服 动态 内 容 了 。 本 章 说 明 在 首页 显示 分 类 的 过 程 ， 并 为 各 分 类 创建 专属 页 面 ， 显 示 分 类 
下 的 链接 。 


6.1 创建 数据 驱动 页 面 的 流程 
在 Django 中 创建 数据 驱动 页 面 主要 分 为 5 步 ， 


在 views py 文件 中 导入 想 使 用 的 模型 。 

在 视图 函数 中 查询 模型 ， 获 取 想 呈现 的 数据 。 
把 从 模型 获取 的 数据 传 给 模板 上 下 文 。 
创建 或 修改 模板 ， 显 示 上 下 文中 的 数据 。 

把 URL 映射 到 视图 上 (如 果 还 未 做 的 话 ) 。 


© © © © 6 


以 上 就 是 在 Django 框架 中 把 模型 、 视 图 和 模板 连接 在 一 起 的 步骤 。 


6.2 在 首页 显示 分 类 


客户 对 主页 的 要 求 之 一 是 显示 最 受 欢迎 的 5 个 分 类 。 下 面 根 据 上 述 步 又 实现 这 一 要 求 。 


导入 所 需 的 模型 


首先 完成 第 一 步 。 打 开 rango/views py 文件 ， 在 顶部 其 他 导入 语句 之 后 从 Rango 应 用 的 models py 
文件 中 导入 Category 模型 : 
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# 导入 Category 模型 
from rango.models import Category 


修改 index 视图 
下 面 完成 第 2 步 和 第 3 步 。 我 们 要 修改 主页 的 视图 函数 ， 即 index()。 根 据 下 述 代码 修改 。 


def index(request): 
# 查询 数据 库 ， 获 取 目 前 存储 的 所 有 分 类 
# 按 点 赞 次 数 倒序 排列 分 类 
# 获取 前 5 个 分 类 (如 果 分 类 数 少 于 5 个 ， 那 就 获取 全 部 ) 
# 把 分 类 列表 放 入 context_dict 字典 
# 稍 后 传 给 模板 引擎 


category_list = Category.objects.order_by('-likes')[:5] 
context_dict = {'categories': category_list} 


# BRAS, RBEP ia 
return render(request, 'rango/index.html', context_dict) 


这 里 的 Category.objects.order_by('-likes')[:5] 从 Category 模型 中 查询 最 受 欢迎 的 前 5 个 分 
类 。order_by() 方 法 的 作用 是 排序 ， 这 里 我 们 根据 likes 字段 的 值 倒序 排列 。-Likes 中 的 - 号 表 
WAF (如 果 没 有 - 号 ， 返回 的 结果 是 升序 排列 的 ) 。 因 为 我 们 想 获得 一 个 分 类 对 象 列表 ， 所 以 
使 用 Python 的 列表 运算 符 从 列表 中 获取 前 5 个 对 象 ([:5]) ， 返 回 一 个 Category 对 象 子 集 。 


查询 结束 后 ， 把 列表 的 引用 (category_list 变量 ) 传 给 context_dict 字典 。 最 后 把 这 个 字典 作 
为 模板 上 下 文 传 给 render() 函数 。 


在 此 之 前 务必 做 完 前 一 章 的 练习 ， 即 为 Category 模型 添加 Likes 字段 。 


修改 index 模板 


更 新 视图 之 后 ， 接 下 来 要 做 第 4 步 ， 更 新 项 目 根 目录 中 templates 目录 里 的 rango/index.html 模 
板 。 根 据 下 述 代码 片段 修改 模板 中 的 HTML, 


<!DOCTYPE htmL> 
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{% load staticfiles %} 

<html> 

<head> 
<title>Rango</title> 

</head> 


<body> 
<hi>Rango says...</h1> 
<div>hey there partner! </div> 


<div> 
{% if categories %} 
<ul> 
{% for category in categories %} 
<li>{{ category.name }}</li> 
{% endfor %} 
</ul> 
{% else %} 
<strong>There are no categories present.</strong> 
{% endif %} 
</div> 


<div> 
<a href="/rango/about/">About Rango</a><br /> 
<img src="{% static "images/rango.jpg" %}" alt="Picture of Rango" /> 
</div> 
</body> 
</html> 


这 里 ， 我 们 使 用 Django 模板 语言 提供 的 if 和 for 控制 语句 呈现 数据 。 在 页 面 的 <body> 元 素 中 ， 
我 们 判断 categories (包含 分 类 列表 的 上 下 文 变量 ) 中 有 没有 分 类 ({% if categories %}) 。 


如 果 有 分 类 ， 构 建 一 个 HTML 无 序列 表 (<ul> 标签 ) 。for 循环 迭代 分 类 列表 ({% for category 
in categories %}) ， 在 列表 项 目 (<li> 标签 ) 中 输出 各 分 类 的 名 称 ({{ category.name }}) 。 


如 果 没 有 分 类 ， 显 示 一 个 消息 ， 指 明 没 有 分 类 。 


从 上 述 代码 片段 可 以 看 出 ，Django 模板 语言 中 的 命令 放 在 {% Al 4} 之 间 ， 而 变量 放 在 {{ 和] 之 
间 。 


现在 访问 Rango 的 主页 应 该 会 看 到 页 面 标题 下 方 显示 着 分 类 列表 ， 如 图 6-1 所 示 。 
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;eee [D Rango x David 


€ CŒ | D http://127.0.0.1:8000/rango/ ongo: 


Rango says... 


hey there partner! 


图 6-1: Rango 首页 显示 动态 生成 的 分 类 列表 


6.3 创建 详情 页 面 


根据 设计 要 求 ， 每 个 分 类 还 有 对 应 的 详情 页 面 。 这 里 有 些 挑战 要 克服 。 我 们 要 定义 一 个 参数 化 视 
图 ， 而 且 URL 模式 中 要 编码 分 类 名 称 。 


URL 设计 和 映射 


先 解决 URL 问题 。 我 们 可 以 在 URL 中 使 用 分 类 的 唯一 ID ， 例 如 /rango/category/1/ 或 /rango/cate- 
gory/2/， 其 中 的 数字 1 和 2 是 分 类 的 唯一 ID。 可 是 从 ID 上 看 不 出 到 底 是 哪个 分 类 。 


更 好 的 方法 是 在 URL 中 使 用 分 类 的 名 称 。 例 如 ， 可 以 通过 URL /rango/category/python/ 访问 与 
Python 相关 的 网 页 列表 。 这 样 的 URL 简单 、 可 读 性 高 ， 而 且 具 有 一 定 的 语义 。 如 果 采 用 这 种 形 
式 ， 还 要 处 理 有 多 个 单词 的 分 类 名 ， 例 如 “Other Frameworks”, 


* 简洁 的 URL * 


使 用 简洁 且 可 读 性 高 的 URL 是 Web 设计 的 重要 一 环 。 详 情 参 见 维基 上 百科 。 


为 此 ， 我 们 要 使 用 Django 提供 的 slugify 函数 。 
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为 分 类 添加 slug 字段 


为 了 得 到 可 读 性 高 的 URL， 我 们 要 为 Category 模型 添加 一 个 别名 (slug) 字段 。 然 后 使 用 Django 
提供 的 slugify 函数 把 空白 蔡 换 为 连 字 符 ， 例 如 "how do i create a slug in django" 将 变 成 
"how-do-i-create-a-slug-in-django", 


令 不 安全 的 URL @ 


URL 中 虽然 可 以 有 空格 ， 但 是 却 会 导致 安全 问题 。 详 情 参 见 因特网 工程 任务 组 (Internet En- 


gineering Task Force) 发 布 的 URL RFC, 


此 外 ， 还 要 覆盖 Category 模型 的 save() 方法 ， 调 用 slugify() 函数 更 新 slug 字段 。 注 意 ， 只 要 
分 类 名 称 变 了 ， 别 名 就 随 之 改变 。 参 照 下 述 代码 片段 更 新 模型 ， 别 忘 了 导入 slugify() 函数 。 


from django.template.defaultfilters import slugify 


class Category(models.Model): 
name = models.CharField(max_length=128, unique=True) 
views = models. IntegerField(defauLt=0) 
likes = models.IntegerField(default=0) 
slug = models.SlugField() 


def save(self, *args, **kwargs): 
self.slug = slugify(self.name) 
super(Category, self).save(*args, **kwargs) 


class Meta: 
verbose_name_plural = 'categories' 


def _str__(self): 
return self.name 


更 新 模型 之 后 ， 接 下 来 要 把 变动 应 用 到 数据 库 上 。 然 而 ， 数 据 库 中 已 经 有 数据 了 ， 因 此 我 们 必须 
考虑 改动 产生 的 影响 。 其 实 我 们 想 做 的 很 简单 ， 就 是 从 分 类 名 称 中 得 到 别名 (此 项 操作 在 初次 保 
存 记录 时 执行 ) 。 通 过 迁移 工具 能 把 slug 字段 添加 到 数据 库 中 ， 而 且 可 以 为 该 字段 指定 默认 值 。 
可 是 ， 每 个 分 类 的 别名 应 该 是 不 同 的 。 因 此 ， 我 们 将 对 执行 迁移 ， 然 后 重新 运行 填充 脚本 。 之 所 
以 这 么 做 ， 是 因为 填充 脚本 会 在 分 类 上 调用 save() 方法 ， 从 而 触发 上 面 实现 的 save() 方法 , 更 
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新 各 分 类 的 别名 。 
执行 下 述 命令 ， 执 行 迁移 : 


$ python manage.py makemigrations rango 
$ python manage.py migrate 


我 们 没有 为 stug 字段 指定 默认 值 ， 而 且 数据 库 中 有 数据 ， 因 此 migrate 命令 会 给 你 两 个 选择 。 选 


择 提 供 默 认 值 的 选项 ， 输 入 一 个 空 字符 串 (两 个 引号 ， 即 '') 。 然 后 运行 填充 脚本 ， 更 新 slug 
字段 。 


$ python populate_rango.py 


执行 python manage.py runserver 命令 ， 启 动 Django 开发 服务 器 ， 在 管理 界面 中 查看 模型 中 的 数 
据 。 


如 果 此 时 通过 管理 界面 添加 分 类 ， 可 能 会 遇 到 一 两 个 问题 。 


@ 假设 要 添加 的 分 类 名 是 “Python User Groups”。 保 存 时 Django 会 阻止 你 ， 让 你 填写 别名 。 虽 
然 可 以 自己 动手 输入 “python-user-groups”"， 但 是 这 样 容易 出 错 。 如 果 能 自动 生成 别名 就 好 
re 

@ 如 果 有 个 分 类 名 为 "Django”， 还 有 个 名 为 "django”， 又 会 遇 到 一 个 问题 。 因 为 slugify() K 
数 生成 的 别名 是 小 写 形式 ， 所 以 无 法 区 分 别名 “django” 对 应 于 哪个 分 类 。 


第 一 个 问题 的 解决 方法 有 两 个 。 其 一 ， 更 新 模型 ， 把 slug 字段 设 为 允许 空 值 : 
slug = models.SlugField(blank=True) 


其 二 ， 定 制 管 理 界面 ， 在 输入 分 类 名 称 时 自动 填写 别名 。 请 参照 下 述 代 码 更 新 rango/admin py. 


from django.contrib import admin 
from rango.models import Category, Page 


# 添加 这 个 类 ， 定 制 管理 界面 
class CategoryAdmin(admin.ModelAdmin): 


prepopuLlated_ fields = {'slug':('name',)} 


# 注册 定制 界面 的 类 


admin.site.register(Category, CategoryAdmin) 
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在 管理 界面 中 添加 一 个 分 类 试 试 。 
第 二 个 问题 也 不 难 解决 ， 只 需 把 slug 字段 设 为 唯一 的 。 为 slug 字段 添加 约束 : 


slug = models.SlugField(unique=True) 


添加 这 个 约束 之 后 便 可 以 通过 别名 唯一 标识 分 类 。 你 可 能 想 在 之 前 就 添加 唯一 性 约束 ， 但 是 这 样 
一 来 执行 迁移 时 把 别名 都 设 为 空 字符 串 就 会 遇 到 问题 ， 因 为 违背 了 唯一 性 约束 。 此 外 也 可 以 删除 
数据 库 ， 然 后 重建 ， 但 这 并 不 适合 所 有 情况 。 


4 迁移 混乱 e 


事先 最 好 规划 好 数据 库 ， 尽 量 不 修改 。 填 充 脚 本 的 作用 是 便于 删除 数据 库 后 重建 。 


有 时 ， 删 除数 据 库 后 重建 比 找 出 问题 后 再 设法 解决 要 方便 。 你 可 以 练习 编写 一 个 脚本 ， 输 出 
数据 库 中 的 数据 。 这 样 每 次 修改 数据 库 都 可 以 把 数据 输出 到 一 个 文件 中 保存 起 来 ， 供 以 后 查 
看 。 


创建 分 类 页 面 的 步骤 


为 了 实现 可 通过 /rango/category/<category-name-slug>/ 访问 的 分 类 页 面 ， 我 们 要 做 几 处 修改 。 基 
本 步骤 如 下 : 


O 把 Page 模型 导入 rango/views py 模块 。 


@ Æ rango/views py 模块 中 定义 一 个 新 视图 ， 命 名 为 show_category()。 这 个 视图 有 个 额外 的 
参数 ，category_name_sLug， 用 于 传人 编码 后 的 分 类 名 称 。 为 了 编码 和 解码 
category_name_sLug， 要 定义 两 个 辅助 函数 。 


© 创建 一 个 模板 ，templates/rango/category.html。 
© 更 新 rango/urlspy. 中 的 urLpatterns， 把 这 个 新 视图 映射 到 URL 模式 上 。 


此 外 还 要 更 新 index() 视图 和 index html 模板 ， 添 加 指向 分 类 页 面 的 链接 。 


分 类 视图 


在 rango/viewspy 中 ， 首 先导 入 Page 模型 ， 即 把 下 述 导 入 语句 添加 到 文件 顶部 : 
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from rango.models import Page 
然后 定义 视图 show_category(), 


def show_category(request, category_name_slug): 
# 创建 上 下 文字 典 ， 稍 后 传 给 模板 洽 染 引擎 
context_dict = {} 


try: 
# 能 通过 传 入 的 分 类 别名 找到 对 应 的 分 类 吗 ? 
# 如 果 找 不 到 ，.get() 方法 抛 出 DoesNotExist 异常 
# 因此 .get() 方法 返回 一 个 模型 实例 或 抛 出 异常 
category = Category.objects.get(slug=category_name_slug) 


# 检索 关联 的 所 有 网 页 
# 注意 ，fiLter() 返回 一 个 网 页 对 象 列表 或 空 列表 
pages = Page.objects.filter(category=category) 


# 把 得 到 的 列表 赋值 给 模板 上 下 文中 名 为 pages 的 键 
context_dict['pages'] = pages 
# 也 ,把 从 数据 库 中 获取 的 category 对 象 添加 到 上 下 文字 典 中 
# 我 们 将 在 模板 中 通过 这 个 变量 确认 分 类 是 否 存在 
context_dict['category'] = category 

except Category.DoesNotExist: 
# 没 找到 指定 的 分 类 时 执行 这 里 
# 什么 也 不 做 
# 模板 会 显示 消息 ， 指 明 分 类 不 存在 
context_dict['category'] = None 
context_dict['pages'] = None 


# BRAN, ABRAR P 3 
return render(request, 'rango/category.html', context_dict) 


这 个 视图 的 基本 步骤 与 index() 视图 一 样 。 首 先 定义 上 下 文字 典 ， 然 后 尝试 从 模型 中 提取 数据 ， 
并 把 相关 数据 添加 到 上 下 文字 典 中 。 我 们 通过 传 给 show_category() 视图 函数 的 
category_name_slug 参数 确认 要 查看 的 是 哪个 分 类 。 如 果 通 过 别名 找到 了 分 类 ， 获 取 与 之 关联 的 
网 页 ， 并 将 其 添加 到 上 下 文字 典 context_dict 中 。 
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分 类 模板 


下 面 为 这 个 新 视图 创建 模板 。 在 <workspace>/tango_with_django_project/templates/rango/ 目录 中 
PVE category htm 文件 ， 写 人 下 述 代码 。 


Ww N e 


D 


<!DOCTYPE html> 
<html> 
<head> 
<title>Rango</title> 
</head> 
<body> 
<div> 
{% if category %} 
<h1>{{ category.name }}</h1> 
{% if pages %} 
<ul> 
{% for page in pages %} 
<li><a href="{{ page.url }}">{{ page.title }}</a></li> 
{% endfor %} 
</ul> 
{% else %} 
<strong>No pages currently in category.</strong> 
{% endif %} 
{% else %} 
The specified category does not exist! 
{% endif %} 
</div> 
</body> 
</html> 


上 述 HTML 代码 再 次 展示 了 如 何 通过 {{ }} 标签 使 用 模板 上 下 文中 的 数据 。 我 们 访问 了 category 
和 pages 对 象 ， 以 及 它们 的 字段 ， 例 如 category.name 和 page.url, 


如 果 category 存在 ， 再 检查 分 类 下 有 没有 网 页 。 如 果 有 ， 使 用 模板 标签 {% for page in pages %} 
迭代 网 页 ， 显 示 pages 列表 中 各 网 页 的 title 和 url 属性 。 网 页 的 信息 在 一 个 HTML 无 序列 表 

(<ul> 标签 ) 中 显示 。 如 果 你 不 熟悉 HTML, ， 可 以 查看 W3Schools.com 网 站 中 的 HTML 教程 ， 
学 习 不 同 的 标签 。 
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BRITS 罩 


使 用 Django 模板 的 条 件 标签 {% if 和 判断 上 下 文中 有 没有 某 个 对 象 十 分 方便 。 为 了 避免 出 
错 ， 应 该 检查 对 象 是 否 存在 。 


在 模板 中 检查 条 件 (例如 上 例 中 的 {% if category %}) 也 更 符合 语义 。 条 件 判断 的 结果 直 
接 影响 呈献 给 用 户 的 页 面 。 记 住 ，Django 应 用 表现 层 的 逻辑 应 该 封装 在 模板 中 。 


带 参 数 的 URL 映射 


下 面 看 看 category_name_sLug 参数 的 值 是 如 何 传 给 show_category() 视图 函数 的 。 打 开 Rango 应 
用 的 urlspy 文件 ， 把 urlpatterns 改 成 下 面 这 样 : 


urlpatterns = [ 
url(r'^$', views.index, name='index'), 
url(r'*about/$', views.about, name='about'), 
url(r'“4category/(?P<category_name_slug>[\w\-]+)/$', 
views.show_category, name='show_category'), 


] 


我 们 添加 了 一 个 相当 复杂 的 URL 模式 ， 当 URL 匹配 
r'Acategory/(?P<category_name_slug>[\w\-]+)/$' 时 调用 views.show_category() AŽ 


这 里 有 两 点 要 注意 。 首 先 ，URL 模式 中 有 个 参数 ， 即 <category_name_sLug>， 在 视图 中 可 以 访 
问 。 声 明 带 参数 的 URL 时 ， 要 确保 对 应 的 视图 中 有 那个 参数 。 其 次 ， 正 则 表达 式 [\w\-]+ 匹配 连 
续 的 数字 字母 ( 即 a-z、A-z 或 6-9， 正 则 表达 式 中 的 \w) 和 连 字 符 (正则 表达 式 中 的 \-) ， 而且 
可 以 匹配 任意 个 (正则 表达 式 中 的 [ ]+) 。 


新 增 的 URL 模型 匹配 rango/category/ 和 末尾 的 / 之 间 的 数字 字母 和 连 字符 序列 。 匹 配 的 序列 存 
储 在 参数 category_name_slug 中 ， 传 给 views.show_category() 函数 。 例 如 ， 对 rango/category/ 
python-books/ 这 个 URL 来 说 ，category_name_sLug 参数 的 值 是 python-books。 然 而 ， 如 果 URL 
是 rango/category/£££LEL-$/, FA rango/category/ 和 末尾 的 / 之 间 的 字符 与 正则 表达 式 不 匹配 ， 此 
时 将 得 到 “404 not found” 错 误 ， 因 为 没有 与 之 匹配 的 URL 模式 。 


Django 应 用 中 的 视图 函数 必须 至 少 有 一 个 参数 。 这 个 参数 通常 命名 为 request， 通 过 它 获 取 与 
HTTP 请 求 有 关 的 信息 。 如 果 URL 中 带 有 人 参数， 必须 为 对 应 的 视图 函数 声明 额外 的 具名 参数 。 鉴 
于 此 ，show_category() 视图 才 定 义 为 def show_category(request, category_name_slug), 
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* TEMA ARE x 


有 些 人 遇 到 问题 时 会 想 ,“ 我 知道 ， 使 用 正则 表达 式 嘛 1 ”现在 他 们 将 面临 两 个 问题 。 


一 一 Jamie Zawinski 


IEW RIERA GOR, REEE, (AE EE BR ZH. HE DALY, 


可 以 使 用 这 个 速 查 表 。 


修改 index 模板 


新 视图 可 用 了 ， 但 是 还 有 一 件 事 要 做 。 我 们 要 修改 首页 的 模板 ， 为 列 出 的 分 类 添加 链接 ， 指 向 分 
类 页 面 。 更 新 index.html 模板 ， 加 入 指向 分 类 页 面 的 链接 。 


<!DOCTYPE htmL> 
{% load staticfiles %} 
<html> 
<head> 
<title>Rango</title> 
</head> 


<body> 
<hi>Rango says...</h1> 


<div> 
hey there partner! 
</div> 


<div> 
{% if categories %} 
<ul> 
{% for category in categories %} 
<!-- 修改 下 面 这 一 行 ， 添 加 链接 --> 
elis 
<a href="/rango/category/{{ category.slug }}">{{ category.name }}</a> 
</li> 
{% endfor %} 
</ul> 
{% else %} 
<strong>There are no categories present.</strong> 
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{% endif %} 
</div> 


<div> 
<a href="/rango/about/">About Rango</a><br /> 
<img src="{% static "“images/rango. jpg" %}" alt="Picture of Rango" /> 
</div> 
</body> 
</html> 


这 里 也 是 使 用 HTML <ul> 标签 定义 一 个 无 序列 表 ， 里 面 有 一 系列 列表 项 目 (<tli>) ， 其 中 有 一 个 
HTML 超 链 接 (<a>) 。 超 链接 有 个 href 属性 ， 其 值 为 /rango/category/{{ category.slug }}。 
Pili, “Python Books” 分 类 对 应 的 URL 是 /rango/category/python-books/。 


检验 结果 


访问 Rango 首页 ， 检查 一 下 劳动 成 果 。 你 应 该 会 看 到 首页 最 多 显示 5 个 分 类 ， 而 且 都 带 超 链 接 。 
点 击 “Django” 会 转 到 Django 分 类 的 页 面 ， 如 图 6-2 所 示 。 如 果 你 看 到 “Official Django Tutoria t 
接 ， 说 明 你 做 的 没 错 。 


访问 不 存在 的 分 类 情况 如 何 呢 ? 访问 一 个 不 存在 的 分 类 试 试 ， 例 如 直接 在 浏览 器 的 地 址 栏 中 输入 
/rango/category/computers/。 你 应 该 会 看 到 一 个 消息 ， 提 示 要 查看 的 分 类 不 存在 。 


@@@ / 2D Rango x David 

€ C | D http://127.0.0.1:8000/rango/category/python onoo: 
. 

Django 


e Official Django Tugyri: 
。 Django Rocks 
e How to Tango wit 10 
| https://docs.djangoproject.com/en/1.9/introjtutorial01/ 


We 


图 6-2: Django 分 类 页 面 显示 的 链接 。 注 意 ， 和 鼠标 悬 停 在 第 一 个 链接 上 ， 在 Google Chrome 浏览 
器 窗口 的 底部 能 看 到 对 应 的 URL, 
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</> 练习 


请 完成 以 下 练习 ， 巩 固 本 昔 所 学 的 知识 。 


C O O Se 2 


* fem x 


更 新 填充 脚本 ， 为 各 网 页 添加 访问 次 数 (views 字段 ) 。 

修改 首页 ， 加 上 访问 次 数 最 多 的 5 个 网 页 。 

为 两 块 信息 添加 标题 ， 分 别 为 “Most Liked Categories” 和 “Most Viewed Pages”, 
在 分 类 页 面 添加 回 到 首页 的 链接 。 

阅读 Django 官方 教程 第 三 部 分 ， 巩 固 本 章 所 学 。 


DJ 更 新 填充 脚本 的 基本 步骤 与 前 一 章 的 练习 一 样 。 各 网 页 的 数据 结构 ， 以 及 处 理 它 们 的 


代码 都 要 更 新 。 


。 更 新 三 个 分 类 中 网 页 的 数据 结构 。 目 前 ， 每 个 网 页 有 title 和 url 字段 。 现 在 ， 
加 上 访问 次 数 ， 即 views 字段 。 

。 填充 脚本 中 的 add_page() 函数 允许 传人 访问 次 数 吗 ? 要 做 什么 修改 吗 ? 

。 最 后 ， 更 新 调用 add_page() 函数 那 行 代码 。 如 果 数 据 结 构 中 的 访问 次 数 用 views 


键 表示 ， 引 用 网 页 的 变量 为 p， 应 该 如 何 把 访问 次 数 传 给 add_page() 函数 呢 ? 


口 记得 重新 运行 填充 脚本 ， 更 新 网 页 的 访问 次 数 。 


”更 新 index 视图 和 index html 模板 ， 在 首页 显示 访问 次 数 最 多 的 网 页 。 
。 现在 不 访问 Category 模型 了 ， 要 通过 Page 模型 获取 访问 次 数 最 多 的 网 页 。 
记得 把 网 页 列表 添加 到 上 下 文中 。 


。 MRA AEE Si 


号 模板 ， 可 以 参考 category htm 模板 。 二 者 基本 是 一 致 的 。 
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127.0.0.1 


Rango says... 


hey there partner! 

Most Liked Categories 
e Python 
e Django 


e Other Frameworks 


e Python User Groups 
Most Viewed Pages 
Official Python Tutorial 


J 
e Bottle 

e Official Django Tutorial 
e 

> 


How to Think like a Computer Scientist 
Flask 


About Rango 


图 6-3: 做 完 练习 后 的 首页 ， 显 示 着 最 受 欢迎 的 分 类 和 访问 次 数 最 多 的 网 页 


太 深入 了 解 模型 k 


如 果 想 深入 了 解 模 型 ， 可 以 阅读 下 面 两 篇 博客 文章 。 


© Kostantin Moiseenko 写 的 Django 模型 最 佳 实践 。 这 篇 文章 给 出 了 很 多 处 理 模型 的 技 
TJ, 
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@ Robert Roskam SAY Django 模型 去 除 重复 指南 。 这 篇 文章 介绍 如 何 通过 类 的 property 


方法 减少 访问 关联 模型 的 代码 量 。 
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表单 


本 章 说 明 如 何 通过 Web 表单 捕获 数据 。Django 提供 的 表单 处 理 功能 简单 明了 ， 根 据 Django X 
档 ， 通 过 这 个 功能 可 以 做 到 : 


O 自动 生成 HIML 表单 的 小 组 件 〈 例 如 文本 字段 或 日 期 选择 器 ) s 
@ 检查 提交 的 数据 是 否 满足 验证 规则 ， 

© 遇 到 验证 错误 时 重新 显示 表单 ; 
O 把 提交 的 表单 数据 转换 成 相应 的 Python 数据 类 型 。 


使 用 Django 表单 功能 的 一 大 优势 是 能 节省 大 量 时 间 ， 免 去 自己 动手 创建 HTML 表单 的 繁琐 过 


程 。 


7.1 基本 流程 


创建 表单 处 理 用 户 输入 的 基本 步骤 如 下 。 


© 在 Django 应 用 的 目录 中 创建 forms.py 文件 ， 存 放 表 单 相关 的 类 。 
@ 为 想 使 用 表单 处 理 的 模型 定义 ModeLForm 类 。 

© 根据 需要 定制 表单 。 

@ 创建 或 更 新 视图 ， 处 理 表单 


”显示 表单 
。 保存 表单 数据 
。 用 户 输入 错误 的 数据 时 (或 者 根本 没 输入 数据 时 ) 报错 
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@ 创建 或 更 新 模板 ， 显 示 表 单 。 
© 添加 URL 模式， 映射 到 视图 上 (如 果 视 图 是 新 的 ) 。 


这 个 流程 比 以 往复 杂 一 些 ， 而 且 相 应 的 视图 要 复杂 得 多 。 不 过 ， 多 做 几 次 便 能 掌握 。 


7.2 网 页 和 分 类 表单 


本 节 实 现 的 功能 是 为 了 让 用 户 通过 表单 向 数据 库 中 添加 分 类 和 网 页 。 


首先 ， 在 Rango 应 用 的 目录 中 新 建 一 个 文件 ， 命 名 为 formspy。 这 一 步 不 是 必须 的 (可 以 放 在 
models py 文件 中 ) ， 但 是 把 表单 相关 的 代码 放 在 单独 的 文件 中 有 利于 保持 代码 基 整 洁 。 


定义 ModelForm 的 子 类 


H forms py 模块 中 ， 我 们 将 定义 几 个 继承 自 ModelForm 的 类 。ModelForn 是 Django 提供 的 辅助 
类 ， 简 化 了 为 模型 创建 表单 的 过 程 。Rango 应 用 现在 有 两 个 模型 (Category 和 Page) ， 我 们 将 分 
别 为 二 者 定义 ModelForm 的 子 类 。 


在 rango/forms py 文件 中 添加 下 述 代码 。 


1 from django import forms 
2 from rango.models import Page, Category 
3 
4 class CategoryForm(forms.ModelForm): 
5 name = forms.CharField(max_length=128, 
6 help_text="Please enter the category name.") 
7 views = forms. IntegerField(widget=forms.HiddenInput(), initial=0) 
8 likes = forms. IntegerField(widget=forms.HiddenInput(), initial=0) 
9 slug = forms.CharField(widget=forms.HiddenInput(), required=False) 
10 
11 # 许 套 的 类 ， 为 表单 提供 额外 信息 
12 class Meta: 
13 # 把 这 个 ModelForm 与 一 个 模型 连接 起 来 
14 model = Category 
15 fields = ('name',) 
16 


17 class PageForm(forms.ModelForm): 
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18 title = forms.CharField(max_Length=128, 
19 help_text="Please enter the title of the page.") 


20 url = forms.URLField(max_lLength=200, 

21 help_text="Please enter the URL of the page.") 
22 views = forms. IntegerField(widget=forms.HiddenInput(), initial=0) 
23 

24 class Meta: 

25 # 把 这 个 ModelForm 与 一 个 模型 连接 起 来 

26 model = Page 

27 

28 # 想 在 表单 中 放 哪 些 字 段 ? 

29 # 有 时 不 需要 全 部 字段 


30 # 有 些 字段 接受 空 值 ， 因 此 可 能 无 需 显示 

31 # 这 里 我 们 想 隐 藏 外 键 字段 

32 # 为 此 ， 可 以 排除 category 字段 

33 exclude = ('category',) 

34 # 也 可 以 直接 指定 想 显示 的 字段 (A category 字段 ) 
35 # fields = ('title', 'url', 'views') 


我 们 要 通过 fields 指定 表单 中 包含 哪些 字段 ， 或 者 通过 exclude 指定 排除 哪些 字段 。 


为 了 定制 得 到 的 表单 ，Django 提供 了 多 种 方式 。 在 上 述 代码 中 ， 我 们 指明 了 使 用 什么 小 组 件 
(widget) 显示 各 个 字段 。 例 如 ， 在 PageForm XP, title 字段 用 的 是 forms.CharField, url 字 
段 用 的 是 forms.URLFieLd。 这 两 种 小 组 件 都 用 于 输入 文本 。 注 意 我 们 为 字段 设 定 的 nax_Length & 
数 ， 其 值 与 底层 数据 模型 中 设 定 的 长 度 限 制 一 样 。 有 具体 限制 参见 第 5 音 ， 或 者 看 一 下 Rango 应 用 
的 models py 文件 。 


此 外 ， 两 个 表单 中 都 有 IntegerFieLd， 用 于 呈现 查看 (VIIA) 次 数 和 点 赞 次 数 。 注 意 ， 我 们 在 参 
数 中 设 定 了 widget=forms.HtddenInput()， 这 是 为 了 隐藏 小 组 件 。 另 外 ， 我 们 还 设 定 了 
initiaL=0， 把 值 设 为 零 。 这 是 把 字段 的 默认 值 设 为 零 的 一 种 方式 。 因 为 字段 是 隐藏 的 ， 用 户 无 法 
为 其 输入 值 。 


然而 ， 如 PageForm 所 示 ， 尽 管 有 个 字段 是 隐藏 的 ， 但 是 依然 要 将 其 包含 在 表单 的 字段 中 。 如 果 

fields 中 没有 views， 表 单 中 就 没有 那个 字段 (虽然 声明 了 ) ， 因 此 那个 字段 的 初始 值 也 就 不 会 
是 零 。 在 某 些 模型 中 ， 这 样 做 可 能 导致 报错 。 如 果 在 模型 中 为 字段 设 定 了 defauLt=0， 那 么 便 可 以 
交 由 模型 自动 使 用 默认 值 填充 字段 ， 从 而 避免 not null 错误 。 此 时 ， 表 单 中 无 需 包 含 那个 字段 。 

CategoryForm 中 包含 slug 字段 ， 但 是 没有 为 其 指定 初始 值 或 默认 值 ， 而 是 隐藏 了 了， 并 且 指 明 这 个 
字段 不 是 必须 的 。 这 是 因为 模型 在 调用 save() 方法 保存 时 会 生成 这 个 字段 的 值 。 综 上 ， 定 义 模 型 
和 表单 时 一 定 要 小 心 ， 确 保 提供 创建 模型 实例 所 需 的 全 部 数据 。 
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除了 CharField 和 IntegerField 2%}, Django 还 提供 了 很 多 可 用 的 小 组 件 ， 例 如 EmailField ( 电 
子 邮 件 地 址 输入 框 ) 、ChoiceField ( 单 选 按钮 ) 和 DateFieLd (日 期 /时 间 输 入 框 ) 。 


对 ModelForm 的 子 类 来 说 ， 最 重要 的 一 点 或 许 是 定义 表单 对 应 的 模型 。 这 个 信息 通过 骸 套 的 Meta 
类 提供 ， 把 model 属性 设 为 目标 模型 。 例 如 ，CategoryForm 类 设 定 的 目标 模型 是 Category。 这 一 
步 十 分 重要 ， 有 了 这 个 信息 Django 才能 根据 模型 创建 表单 ， 并 在 提交 表单 后 显示 可 能 出 现 的 错 


误 。 


我 们 还 通过 Meta 类 的 fields 属性 〈 值 为 一 个 元 组 ) 设 定 表 单 中 包含 哪些 字段 。 


如 果 想 进一步 了 解 不 同 的 小 组 件 ， 以 及 定制 表单 的 方法 ， 请 阅读 Django 文档 。 


编写 添加 分 类 视图 


定义 好 CategoryForm 类 之 后 ， 接 下 来 要 编写 一 个 视图 ， 用 于 显示 表单 及 处 理 提 交 的 数据 。 在 ran- 
go/views py 文件 中 添加 下 述 代码 。 


# 在 文件 顶部 添加 这 个 导入 语句 
from rango.forms import CategoryForm 


def add_category(request): 
form = CategoryForm() 


# 是 HTTP POST 请 求 吗 ? 
if request.method == 'POST': 
form = CategoryForm(request.POST) 


# 表单 数据 有 效 吗 ? 

if form.is_valid(): 
# 把 新 分 类 存 入 数据 库 
form.save(commit=True) 
# 保存 新 分 类 后 可 以 显示 一 个 确认 消息 
# 不 过 既然 最 受 欢迎 的 分 类 在 首页 
# 那 就 把 用 户 带 到 首页 吧 
return index(request) 

else: 
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# 表单 数据 有 错误 
# BiAA in EATE h k 
print(form.errors) 


# 处 理 有 效 数 据 和 无 效 数 据 之 后 
# 泻 染 表单 ， 并 显示 可 能 出 现 的 错误 消息 
return render(request, 'rango/add_category.html', {'form': form}) 


add_category() 视图 展示 了 处 理 表 单 的 关键 步骤。 首先 ， 创 建 一 个 CategoryForm 实例 ， 然 后 检查 
是 不 是 HTTP POST 请 求 ， 即 是 不 是 通过 表单 提交 的 数据 ? 相同 的 URL 也 可 以 处 理 GET 请 求 。 
add_category() 视图 能 处 理 不 同 的 情况 : 


1 显示 一 个 空 表单 ， 让 用 户 添加 分 类 ， 
J 把 用 户 提 交 的 数据 存 和 人 相应 的 模型 ， 然 后 泻 染 Rango 应 用 首页 ， 
J 如 有 错误 ， 再 次 显示 表单 ， 并 把 错误 消息 一 并 显示 出 来 。 


@ GET vs. POST? @ 


GET 和 POST 是 两 种 HTTP 请 求 类 型 ， 二 者 之 间 的 区 别 如 下 : 


HTTP GET 请 求 获取 指定 资源 的 表述 。 即 HTTP GET 请 求 用 于 获取 特定 的 资源 ， 例 如 
一 个 网 页 、 一 张 图 像 或 一 个 文件 。 

O HTTP POST 请 求 提交 客户 端 中 的 数据 ， 供 服务 器 处 理 。 提 交 HTML 表单 发 送 的 就 是 
这 种 请 求 。HTTP POST 请 求 的 最 终结 果 可 能 是 在 服务 器 中 新 建 一 个 资源 (并存 人 数 
据 库 ) 。 新 建 的 资源 可 通过 HITP GET 请 求 访问 。 


详情 参见 w3schools 网 站 中 对 二 者 的 比较 。 


Django 的 表单 处 理 机 制 负 责 处 理 通 过 HTTP POST 请 求 提 交 的 数据 ， 一 切 顺利 时 ， 把 数据 存 人 相 
应 的 模型 ， 否 则 生成 各 字段 的 出 错 消息 。 也 就 是 说 ， 如 果 提 交 的 表单 数据 违背 了 数据 库 的 引用 完 
整 性 ，Django 会 拒绝 保存 数据 。 例 如 ， 如 果 不 为 category 字段 提供 值 就 会 出 错 ， 因 为 这 个 字段 不 
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从 调用 render() 函数 那 行 可 以 看 出 ， 我 们 使 用 的 是 一 个 新 模板 ， 名 为 add_category.himl, IAR 
面 和 表单 的 HTML 代码 及 相关 的 Django 模板 代码 都 在 这 个 模板 中 。 
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创建 添加 分 类 页 面 的 模板 


新 建 templates/rango/add_category.himl 文件 ， 写 人 下 述 HTML 标记 和 Django 模板 代码 。 


1 <!DOCTYPE html> 


2 <html> 

3 <head> 

4 <title>Rango</title> 

5 </head> 

6 

7 <body> 

8 <h1>Add a Category</h1> 

9 <div> 
10 <form id="category_form" method="post" action="/rango/add_category/"> 
11 {% csrf_token %} 
12 {% for hidden in form.hidden_fields %} 
13 {{ hidden }} 
14 {% endfor %} 
15 {% for field in form.visible_fields %} 
16 {{ field.errors }} 
17 {{ field.help_text }} 
18 {{ field }} 
19 {% endfor %} 
20 <input type="submit" name="Submit" value="Create Category" /> 
21 </form> 
22 </div> 
23 </body> 


24 </html> 


这 个 HTML 页 面 的 <body> 中 有 个 <form> 元 素 。 通 过 <form> 元 素 的 属性 可 以 看 出 ， 这 个 表单 捕获 
的 数据 通过 HTTP POST 请 求 发 给 URL /rango/add_category/ (method 属性 的 值 不 区 分 大 小 写 ， 
此 POST 或 post 都 行 ) 。 这 个 表单 中 有 两 个 循环 : 


2 一 个 显示 表单 的 隐藏 字段 
J 一 个 显示 表单 的 可 见 字段 


可 见 字 段 ， 即 会 显示 出 来 的 字段 ， 由 Meta 类 的 fields 属性 控制 。 这 两 个 循环 负责 生成 各 表单 元 
素 的 HTML 标记 。 可 见 字段 中 还 加 上 了 可 能 出 现 的 错误 ， 以 及 辅助 文本 ， 提 示 用 户 应 该 输入 什 
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Ss 


因为 HITP 是 无 状态 的 协议 ， 所 以 除了 可 见 字段 之 外 ， 还 要 加 上 隐藏 字段 。 由 于 两 个 HTTP 
请 求 之 间 无 法 持久 保持 状态 ， 因 此 Web 应 用 的 某 些 功能 难以 实现 。 为 了 解决 这 一 难题 ， 人 
们 发 明了 隐藏 字段 ， 以 便 通过 HTML 表单 发 送 对 客户 端 来 说 重要 的 信息 (在 泻 染 的 页 面 中 
看 不 到 ) ， 在 用 户 提交 表单 时 发 给 服务 器 。 


4 跨 站 请 求 伪造 令 牌 © 


请 特别 注意 上 述 代 码 片段 中 的 {% csrf_token 。 这 是 跨 站 请 求 伪 造 (Cross-Site Request 
Forgery, CSRF) 令 牌 ， 用 于 增强 提交 表单 后 发 送 的 HTTP POST 请 求 的 安全 性 。Django 框 
架 要 求 表单 中 必须 有 CSRF 令 牌 ， 和 否则 用 户 提 交 表 单 后 可 能 遇 到 错误 。 详 情 参见 Django X 
档 (Django 1.10 的 文档 ) 。 


映射 添加 分 类 视图 


接 下 来 要 把 add_category() 视图 映射 到 一 个 URL 上 。 在 模板 中 ， 表 单 的 action 属性 使 用 的 URL 
是 /rango/add_category/。 现 在 要 把 这 个 URL 映射 到 视图 上 。 打 开 rango/urls.py 文件 ， 修 改 


urlpatterns; 


urlpatterns = [ 
url(r'^$', views.index, name='index'), 
url(r'about/$', views.about, name='about'), 
url(r'*add_category/$', views.add_category, name='add_category'), 
url(r'*category/(?P<category_name_sLug>[\w\-]+)/$', 
views.show_category, name='show_category'), 


] 


这 个 URL 模式 的 位 置 没什么 关系 。 不 过 ， 请 阅读 Django 文档， 了解 Django 是 如 何 处 理 请 求 的 。 
添加 分 类 页 面 的 URL 是 /rango/add_category/ , 
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修改 首页 视图 
最 后 ， 在 首页 添加 一 个 链接 ， 方 便 用 户 添加 分 类 。 打 开 rangolindexhim 模板 ， 在 "关于 "页 面 链接 
所 在 的 <div> 元 素 中 添加 下 述 HTML 超 链接 ， 


<a href="/rango/add_category/">Add a New Category</a><br /> 


检验 结果 


现在 检验 一 下 结果 。 启 动 或 重启 Django 开发 服务 器 ， 打 开 浏 览 器 ， 访 问 http-//127.0.0.1:8000/ran- 
80/。 点 击 新 加 的 那个 链接 ， 跳 转 到 添加 分 类 页 面 ， 添 加 一 个 分 类 试 试 。 下 图 是 首页 和 添加 分 类 页 
面 的 截图 。 


127.0.0.1 o) ab 


Rango says... 
hey there partner! 


Most Liked Categories 


e Python 
e Django 
e Other Frameworks 


e Python User Groups 


e Pascal 


127.0.0.1 


Add a Category 


Please enter the category name. Pascal Create Category 


图 7-1: 通过 表单 添加 一 个 分 类 


你 添加 的 分 类 可 能 不 会 出 现在 首页 ， 这 是 因为 首页 只 显示 最 受 欢迎 的 前 5 个 分 类 。 登 录 进 入 
管理 界面 可 以 看 到 全 部 分 类 。 
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确认 分 类 成 功 添加 的 另 一 种 方法 是 修改 rango/views.py 文件 中 的 add_category() 函数 ， 把 
form.save(commit=True) 改 成 cat = form.save(commit=True)， 为 通过 表单 创建 的 分 类 对 象 
提供 一 个 引用 ， 这 样 便 可 以 在 控制 台中 打印 分 类 ， 例 如 print(cat，cat.sLug)。 


清理 表单 数据 


你 或 许 还 记得 ，Page 模型 有 个 url 属性 ， 其 类 型 为 URLField。 在 对 应 的 HTML 表单 中 ，Django 
期 望 这 个 字段 中 的 文本 是 格式 正确 的 完整 URL。 然 而 ， 用 户 可 能 觉得 输入 Attp-//www.url.com 这 样 
的 URL 很 麻烦 ， 其 至 根本 不 知道 何 为 正确 的 URL 格式 。 


E URL 检查 E 


多 数 现代 浏览 器 会 检查 URL 的 格式 是 否 正确 ， 因 此 这 里 所 说 的 情况 只 针对 旧 浏 览 器 。 虽 然 


如 此 ， 但 是 其 中 涉及 如 何在 存 人 数据 库 之 前 清理 数据 。 如 果 你 没有 旧 浏览 器 做 试验 (或 者 你 
不 相信 ) ， 可 以 把 URLFietd 更 换 成 charField， 这 样 演 染 得 到 的 HTML 便 不 会 指示 浏览 器 做 


今 查 ， 我 们 编写 的 清理 代码 就 能 执行 


为 了 防止 用 户 输入 的 数据 有 错 ， 我 们 可 以 在 ModelForm 子 类 中 覆盖 clean() 方法 。 这 个 方法 在 数 
据 存 为 新 模型 实例 之 前 调用 ， 因 此 在 这 一 时 刻 特别 适合 确认 (其 至 修正 ) 用 户 在 表单 中 输入 的 数 
据 。 我 们 可 以 检查 用 户 在 url 字段 中 输入 的 值 是 否 以 http:// 开头 ， 如 果 不 是 ， 在 用 户 输入 的 值 
前 面 加 上 http://。 


class PageForm(forms .ModeLForm) : 


def clean(self): 
cleaned_data = self.cleaned_data 
url = cleaned _data.get('url') 


# 如 果 url 字段 不 为 室 ， 而 且 不 以 “http://” 开 头 
# 在 前 面 加 上 “http://” 
if url and not url.startswith('http://'): 
url = ‘'http://' + url 
cleaned _data['url'] = url 


return cleaned_data 
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在 clean() 方法 中 ， 基 本 的 处 理 过 程 是 一 样 的 ， 你 可 以 轻易 套用 ， 按 照 自己 的 方式 处 理 表单 数 


据 。 


© 表单 数据 从 cleaned_data 字典 中 获取 。 


@ 要 检查 的 表单 字段 使 用 字典 的 .get() 方法 从 cleaned_data 字典 中 获取 。 如 果 用 户 未 在 某 
个 表单 字段 中 输入 值 ， 那 么 cleaned_data 字典 中 便 没 有 对 应 的 键 值 对 。 此 时 ，.get() 方法 
返回 None， 而 不 抛 出 KeyError 异常 。 这 样 能 让 代码 稍微 简洁 一 点 。 


O 先 检查 要 处 理 的 表单 字段 中 有 没有 值 ， 如 果 有 再 检查 值 是 什么 。 如 果 发 现 值 不 符合 预期 ， 


那 就 做 些 处 理 ， 然 后 把 新 值 存 人 cleaned_data 字典 。 


O c 


= Ake A 
个 简 征 


lean() 方法 的 最 后 必须 返回 cleaned_data 字典 的 引用 。 和 否则 改动 不 生效 。 


的 示例 展示 了 如 何在 保存 之 前 清理 数据 。ctean() 方法 特别 有 用 ， 尤 其 适合 为 字段 提供 


这 


默认 值 ， 


太 复 盖 方法 x 


或 者 为 用 户 没 有 填写 的 字段 提供 值 。 


覆盖 Django 框架 的 方法 能 为 你 的 应 用 添加 额外 的 功能 。 除 了 ModelForm 类 的 clean() 方法 之 


外 ， 还 有 很 多 方法 可 以 放心 覆盖 ， 详 情 参见 Django 文档 。 


</> 练习 


本 章 内 容 结束 了 ， 请 看 下 面 的 问题 ， 想 一 想 应 该 怎么 解决 。 


Se Be E 


在 添加 分 类 表单 中 如 果 不 输入 分 类 名 称 会 发 生 什么 ? 
如 果 添 加 的 分 类 已 经 存在 会 发 生 什么 ? 
如 采访 问 不 存在 的 分 类 会 发 生 什么 ?后 文 有 提示 。 


定义 ModelForm 子 类 时 ， 我 们 为 某 些 字段 设 定 了 max_Length 参数 ， 这 与 模型 中 的 验证 
重复 了 。 想 想 如 何 重 构 ， 以 免 重复 指定 max_Length 值 ? 


阅读 Django 官方 教程 第 四 部 分 ， 巩 固 本 革 所 学 。 
让 用 户 能 在 分 类 中 添加 网 页 。 参 见 下 面 的 示例 代码 和 提示 。 
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创建 添加 网 页 的 视图 、 模 板 和 URL 映射 


接 下 来 应 该 让 用 户 能 在 分 类 中 添加 网 页 。 基 本 步 又 与 添加 分 类 一 样 。 


J 编写 一 个 视图 ，add_page() 

口 创建 一 个 模板 ，rango/add_page html 

2 添加 一 个 URL 映射 

1 更 新 分 类 页 面 的 模板 和 视图 ， 加 上 添加 网 页 链接 


下 面 给 出 add_page() 视图 函数 ， 给 你 一 点 提示 。 


from rango.forms import PageForm 


def add_page(request, category_name_slug): 
try: 
category = Category.objects.get(slug=category_name_slug) 
except Category.DoesNotExist: 
category = None 


form = PageForm() 
if request.method == 'POST': 
form = PageForm(request. POST) 
if form.is_valid(): 
if category: 
page = form.save(commit=False) 
page.category = category 
page.views = 0 
page.save() 
return show_category(request, category_name_slug) 
else: 


print(form.errors) 


context_dict = {'form':form, 'category': category} 
return render(request, 'rango/add_page.html', context_dict) 
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k fem x 


如 果 你 觉得 练习 有 难度 ， 下 面 给 你 一 些 提示 。 


2 在 add_page.html 模板 中 可 以 通过 {{ category.slug H 访问 分 类 的 别名 ， 因 为 视图 通 
过 上 下 文字 典 把 category 对 象 传 给 模板 了 。 


仅 在 请 求 的 分 类 存在 时 才 显 示 链 接 。 在 模板 中 使 用 if 标签 判断 : {% if cat %} .... 
{% else %} A category by this name does not exist {% endif %}, 


在 Rango 的 category html 模板 中 添加 一 个 链接 ， 后 面 带 有 换行 : <a href="/rango/ 


category/{{category.slug}}/add_page/">Add Page</a> <br/>, 


add_page.himl 模板 中 的 表单 要 把 请 求 发 给 /rango/category/{{ category slug 
}add_page/ , 


更 新 rango/urlspy， 添 加 一 个 URL 映射 处 理 上 述 链接 。 


为 了 避免 重复 设 定 max_length 参数 ， 可 以 在 Category 类 中 声明 一 个 属性 ， 用 它 i 
最 大 长 度 限 制 ， 然 后 在 需要 的 地 方 引 用 这 个 属性 。 


如 果实 在 不 知道 怎么 做 ， 请 查看 GitHub 中 的 代码 。 
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模板 进 阶 


目前 ， 我 们 为 Rango 应 用 的 几 个 页 面 创建 了 HTML 模板 。 你 可 能 发 现 了 ， 不 同 模板 之 间 有 很 多 
HTML 代码 是 重复 的 ， 这 违背 了 DRY 原则 。 此 外 ， 你 可 能 也 注意 到 了 ， 链 接 中 使 用 的 是 便 编 码 
的 URL 路 径 。 这 些 问题 会 导致 网 站 难以 维护 ， 倘 知 想 改变 网 站 的 整体 结构 ， 或 者 调整 URL 路 
径 ， 每 个 模板 都 要 修改 。 


本 章 使 用 模板 继承 解决 第 一 个 问题 ， 使 用 URL 模板 标签 解决 第 二 个 问题 。 先 看 第 二 个 问题 。 


8.1 使 用 相对 URL 


目前 ， 模 板 中 的 链接 地 址 使 用 的 是 硬 编码 的 URL， 例 如 <a href="/rango/about/">About</a>, iX 
样 做 的 缺点 是 一 旦 修改 了 urlspy 中 的 URL 上 映射， 就 要 更 新 对 应 的 所 有 URL 引用 。 正 确 的 方法 是 
使 用 模板 标签 url 查询 urls.py 文件 中 的 URL Bist, 动态 插入 URL 路 径 。 


在 模板 中 使 用 相对 URL 十 分 简单 。 若 想 链接 到 关于 页 面 ， 可 以 在 模板 中 插入 下 面 这 行 代码 : 


<a href="{% url 'about' %}">About</a> 


Django 模板 引擎 会 检查 urls. py 模块 中 有 没有 name 属性 的 值 为 about 的 URL 模式 ， 然 后 反 向 匹配 
URL。 这 样 一 来 ， 如 有 果 修改 了 urls py 模块 中 的 URL 映射 ， 无 需 一 个 一 个 修改 模板 。 


URL 模式 也 可 以 不 通过 名 称 引 用 ， 而 是 直接 引用 视图 ， 如 下 所 示 : 
<a href="{% url 'rango.views.about' %}">About</a> 


此 时 ， 必 须 保 证 rango 应 用 的 views py 模块 中 有 名 为 about 的 视图 。 


Rango 应 用 的 index html 模板 中 有 个 带 参 数 的 URL, Bp /rango/category/{{ category.slug }}, F Y X% 
免 硬 编码 ， 我 们 可 以 使 用 url 模板 标签 ， 并 指定 URL (或 视图 ) 的 名 称 和 分 类 的 别名 ， 如 下 所 
JR: 


{% for category in categories %} 
<li> 
<a href="{% url 'show_category' category.slug %}"> 
{{ category.name }} 
</a> 
</lis 
{% endfor %} 


别 忙 着 把 所 有 模板 中 硬 编码 的 URL 都 更 改 为 相对 URL， 在 此 之 前 我 们 先 利用 模板 继承 调整 模板 
结构 ， 去 除 重复 。 


E URL 和 多 个 Django 应 用 E 


本 书 只 专注 于 开发 一 个 Django 应 用 ， 即 Rango。 然 而 ， 你 的 Django 项 目 中 可 能 有 多 个 应 
用 ， 说 不 定 有 几 百 个 URL。 这 就 引出 一 个 问题 ， 这么 多 URL 要 怎么 组 织 呢 ? 毕竟 两 个 应 用 
中 可 能 存在 同名 视图 ， 从 而 导致 冲突 。 


为 了 解决 这 个 问题 ，Django 为 各 应 用 的 URL 配置 模块 提供 了 命名 空间 。 在 应 用 的 urls py 模 
块 中 加 上 app_name 变量 就 设 定 了 命名 空间 。 下 述 示例 把 Rango 应 用 的 命名 空间 设 为 rango, 


from django.conf.urls import url 
from rango import views 


app_name = 'rango' 
urlpatterns = [ 


url(r'^$', views.index, name='index'), 


] 


添加 app_name 变量 后 ， 要 像 下 面 这 样 引用 Rango 应 用 中 的 URL: 
<a href="{% url 'rango:about' %}">About</a> 


url 标签 中 的 冒号 负责 分 开 命 名 空间 和 URL 名 称 。 


这 是 个 高 级 功能 ， 同 一 个 项 目 中 有 多 个 应 用 时 才能 用 得 到 ， 不 过 现在 知道 也 没什么 坏处 。 
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8.2 去 除 重 复 


几乎 每 个 专业 的 网 站 都 有 一 系列 重复 的 组 件 ， 侈 如 页 头 、 侧 边栏 和 页 脚 ， 但 是 每 个 页 面 都 重复 纺 
写 这 些 组 件 的 HTML 显然 是 不 明智 的 。 试 想 ， 如 果 要 调整 网 站 的 页 头 呢 ? 你 要 修改 每 个 页 面 ， 换 
用 新 的 页 头 。 这 是 个 费时 的 工作 ， 而 且 可 能 出 现 人 为 错误 。 


为 免 浪费 时 间 复 制 粘贴 HTML 标记 ， 我 们 可 以 利用 Django 模板 引擎 提供 的 模板 继承 功能 尽量 避 
RER, 


使 用 模板 继承 的 基本 步 又 如 下 。 
O 找 出 模板 中 重复 出 现 的 部 分 ， 例 如 页 头 、 侧 边栏 、 页 脚 和 内 容 区 。 有 时 ， 你 可 以 把 各 页 面 
的 结构 画 在 纸 上 ， 这 样 便于 找 出 通用 的 部 分 。 


@ 创建 一 个 基 模 板 (base template) ， 实 现 页 面 的 基本 骨架 结构 ， 提 供 通用 的 部 分 〈 例 如 页 头 
的 徽标 和 标题 ， 页 脚 的 版 权 声明 ) ， 并 定义 一 些 区 块 (block) ， 以 便 在 不 同 的 页 面 调整 所 
显示 的 内 容 。 


@ 为 应 用 的 不 同 页 面 创建 专门 的 模板 ， 都 继承 自 基 模板 ， 然 后 指定 各 区 块 的 内 容 。 


在 基 模 板 中 定义 重复 出 现 的 HTML 


显然 ， 目 前 我 们 创建 的 模板 有 很 多 重复 的 HTML 代码 。 下 面 把 各 页 面 显 示 的 具体 内 容 剔 除 ， 得 到 
各 模板 重复 使 用 的 骨架 结构 。 


1 <!DOCTYPE html> 
{% load staticfiles %} 


<html> 
<head lang="en"> 
<meta charset="UTF-8" /> 
<title>Rango</title> 
</head> 
<body> 
<!-- 各 页 面 的 具体 内 容 --> 
</body> 
</htmL> 


我 们 暂且 把 这 个 HTML 页 面 作 为 Rango 应 用 的 基 模 板 。 把 上 述 代 码 保存 在 templates/rango/ 目录 
中 的 base html 文件 里 。 
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@ DOCTYPE 放 在 开头 @ 


记 住 ，<!DOCTYPE html> 声明 必须 放 在 模板 的 第 一 行 。 如 若 不 然 ， 泻 染 得 到 的 页 面 可 能 不 符 


合 W3C HTML 指导 方针 。 


定义 区 块 


创建 好 基 模 板 之 后 ， 接 下 来 要 指明 模板 中 的 哪些 部 分 可 由 继承 它 的 模板 覆盖 。 为 此 ， 要 使 用 
block 标签 。 例 如 ， 可 以 像 下 面 这 样 在 base.html 模板 中 添加 body_block 区 块 : 


1 <!DOCTYPE htmL> 

2 {% load staticfiles %} 

3 

4 <html> 

5 <head Lang="en"> 

6 <meta charset="UTF-8" /> 
7 <title>Rango</title> 

8 </head> 

9 <body> 
10 {% block body_block %} 
11 {% endblock %} 
12 </body> 
13 </html> 


还 记得 吗 ，Django 模板 标签 放 在 {% FI %} 之 间 。 因 此 ， 区 块 以 {% block <NAME> %} 开头 ， 其 中 
<NAME> 是 区 块 的 名 称 。 区 块 必须 以 endblock 结尾 ， 而 且 也 要 放 在 {% Fl %} 之 间 ， 即 {% endblock 
%}。 


可 以 为 区 块 指 定 默认 内 容 ， 在 子 模板 没有 提供 该 区 块 的 内 容 时 使 用 ( 见 8.3 节 ) 。 指 定 默 认 内 容 
的 方法 是 在 {% block %} 和 {% endblock %} 之 间 添 加 HTML 标记 ， 如 下 所 示 。 


{% block body_block %} 
This is body_block's default content. 
{% endblock %} 


创建 各 页 面 的 模板 时 ， 我 们 将 继承 rango/base htm 模板 ， 然 后 覆盖 body_block 区 块 的 内 容 。 模 板 
中 的 区 块 数量 不 限 ， 可 以 根据 需要 定义 。 例 如 ， 可 以 创建 页 面 标 题 区 块 、 页 脚 区 块 、 侧 边栏 区 
H, SS, KEE Django 模板 系统 一 个 特别 强大 的 功能 ， 详 情 参见 Django 文档 。 
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* 提取 通用 结构 太 


在 基 模 板 中 要 尽量 提取 重复 出 现 的 内 容 。 这 样 做 看 起 来 麻烦 ， 但 是 后 期 节省 的 维护 时 间 远 比 


这 多 。 


思考 是 痛 兰 的 ， 但 总 比 做 很 多 单调 的 工作 要 好 ! 


进一步 抽象 


了 解 区 块 的 作用 之 后 ， 下 面 进一步 抽象 基 模 板 。 打 开 rango/base.himl 模板 ， 像 下 面 这 样 修改 : 


1 <!DOCTYPE html> 
2 {% load staticfiles %} 
3 
4 <html> 
5 <head> 
6 <title> 
74 Rango - 
8 {% block title_block %} 
9 How to Tango with Django! 
10 {% endblock %} 
14 </title> 
12 </head> 
13 <body> 
14 <div> 
15 {% block body_block %} 
16 {% endblock %} 
17 </div> 
18 <hr /> 
19 <div> 
20 <ul> 
21 <li><a href="{% url 'add_category' %}">Add New Category</a></li> 
22 <li><a href="{% url 'about' %}">About</a></li> 
23 <li><a href="{% url 'index' %}">Index</a></li> 
24 </ul> 
25 </div> 
26 </body> 
27 </html> 
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上 述 代码 对 基 模 板 做 了 两 处 改动 : 


J 首先 是 增加 了 title_block 区 块 。 这 样 在 子 模板 中 可 以 为 各 页 面 定制 标题 。 如 果子 模板 没 

有 覆盖 这 个 区 块 ， 使 用 默认 值 How to Tango with Django!， 得 到 的 页 面 标题 为 Rango - 
How to Tango with Django!。 请 仔细 看 一 下 上 述 代码 片段 中 的 <title> 标签 。 

口 FE index.html 模板 中 的 几 个 链接 放 在 HTML <div> 标签 里 ， 放 到 body_block 区 块 下 面 。 这 
样 所 有 继承 的 子 模板 都 将 具有 这 些 链接 。 这 组 链接 前 面 有 条 水 平 线 (<hr />) ， 目 的 是 从 
视觉 上 把 链接 与 body_block 区 块 分 开 。 


8.3 模板 继承 


创建 好 基 模 板 之 后 ， 接 下 来 要 更 新 其 他 模板 ， 让 它们 继承 基 模 板 。 先 重 构 rango/category html 模 
板 。 


首先 把 模板 中 重复 的 HTML 代码 删除 ， 只 留 下 对 所 在 页 面 有 用 的 模板 标签 或 命令 。 然 后 在 模板 的 
开头 添加 下 面 这 行 代 码 : 


{% extends 'rango/base.html' %} 


extends 命令 接受 一 个 参数 ， 即 要 扩展 (继承 ) 的 模板 。 这 个 参数 的 值 是 个 路 径 ， 相 对 项 目的 
templates 目录 。 例 如 ，Rango 应 用 中 的 模板 都 继承 rango/base.html， 而 不 是 base.html。 继 续 修改 
category html 模板 ， 如 下 所 示 : 


{% extends 'rango/base.html' %} 
{% load staticfiles %} 


{% block title_block %} 
{{ category.name }} 
% endblock %} 


Aa 


Aa 


8 {% block body_block %} 
9 {% if category %} 
<hi>{{ category.name }}</h1> 


12 {% if pages %} 
<ul> 
{% for page in pages %} 
<li><a href="{{ page.url }}">{{ page.title }}</a></li> 


CO 
O 
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16 {% endfor %} 


17 </ul> 

18 {% else %} 

19 <strong>No pages currently in category.</strong> 

20 {% endif %} 

21 <a href="{% url 'add page' category.slug %}">Add a Page</a> 
22 {% else %} 

23 The specified category does not exist! 

24 {% endif %} 


25 {% endblock %} 


Mz staticfiles @ 


用 到 静态 文件 的 每 个 模板 都 要 在 文件 顶部 添加 {% load staticfiles %}, AM SRR! 
对 Django 模板 而 言 ， 必 须 在 用 到 模块 的 每 个 模板 中 导入 模块 。 这 与 面向 对 象 编程 语言 ( 例 


如 Java) 有 所 不 同 。 在 面向 对 象 编程 语言 中 ， 导 入 的 模块 会 沿 着 类 继承 体系 向 下 延伸 。 注 意 
我 们 是 如 何 使 用 url 模板 标签 引用 rango/<category-name>/add_page/ URL 模式 的 。 
category.slug 作为 参数 传 给 url 模板 标签 ，Django 模板 引擎 会 据 此 生成 正确 的 URL, 


现在 category html 模板 继承 自 rango/base.html, 3:4) RET title_block 和 body_block 区 块 ， 变 得 
简洁 多 了 。category.html 模板 不 必 是 完整 的 HTML 文档 ， 因 为 base.himl 提供 了 所 需 的 结构 。 我 们 
只 需 在 基 模 板 的 基础 上 添加 所 需 的 内 容 ， 这 样 便 能 泻 染 得 到 完整 的 HIML 文档 ， 发 给 客户 端 。 泻 
染 得 到 的 HTML 文档 符合 标准 ， 包 含 所 需 的 各 部 分 标记 ， 例 如 第 一 行 的 文档 类 型 声明 。 


大 深入 了 解 模板 六 


这 里 我 们 只 说 明了 如 何 尽 量 减少 模板 中 重复 的 HTML 结构 。 然 而 ，Django 模板 语言 还 有 很 
多 强大 的 功能 ， 其 至 可 以 自 定义 模板 标签 。 


利用 模板 还 能 减少 应 用 视图 的 代码 。 例 如 ， 如 果 你 想 在 每 个 页 面 中 展示 从 数据 库 中 获取 的 特 
定 内 容 ， 可 以 专门 定义 一 个 视图 ， 在 对 应 的 模板 中 展示 这 部 分 内 容 。 这 样 就 无 需 在 需要 显示 
这 部 分 内 容 的 每 个 模板 中 都 调用 Django ORM 函数 获取 所 需 的 数据 。 


现在 ,请 花 点 时 间 阅 读 Django 文档 中 有 关 模 板 的 说 明 。 
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8.4 render() 函数 和 request EFX 


视图 有 多 种 演 染 模板 的 方式 ， 不 过 首选 的 是 Django 提供 的 简洁 方式 ， 即 render() 函数 。 
render() 函数 的 第 一 个 参数 是 request 上 下 文 ， 里 面 有 大 量 信 息 ， 包 括 会 话 和 用 户 等 等 ， 详 情 参 
JL Django 文档 。 把 request 传 给 模板 意味 着 ， 我 们 可 以 在 模板 中 访问 其 中 的 信息 。 下 一 章 将 访问 
关于 用 户 的 信息 。 现 在 请 检查 一 下 所 有 视图 ， 确 保 都 是 用 render() 函数 泻 染 模 板 的 。 如 若 不 然 ， 
后 面 就 得 不 到 所 需 的 信息 。 


x 如 何 检查 ? x 


下 面 以 about() 视图 为 例 说 明 如 何 检查 和 修改 。about() 视图 目前 的 实现 方式 是 硬 编 码 啊 应 
字符 串 ， 如 下 所 示 。 注 意 ， 我 们 只 是 发 送 字符 串 ， 没 有 用 到 传人 视图 的 request 参数 。 


def about(request): 
return HttpResponse('Rango says: Here is the about page. 
<a href="/rango/">Index</a>') 


为 了 改 用 模板 ， 我 们 要 调用 render() 函数 ， 并 传人 request 对 象 。 这 样 修改 之 后 ， 模 板 引擎 
就 能 访问 关于 请 求 〈 例 如 请 求 类 型 ，GET sy POST) 和 用 户 (例如 用 户 的 状态 ， 参 见 第 9 
=) 的 信息 了 。 


def about(request): 
# 打印 请 求 方法 ， 是 GET 还 是 POST 
print(request.method) 
# 打印 用 户 名 ， 如 未 登录 ， 打 印 “AnonymousUser” 
print(request.user) 
return render(request, 'rango/about.html', {}) 


TEE, render() 函数 的 最 后 一 个 参数 是 上 下 文字 典 ， 用 于 把 额外 的 数据 传 给 Django 模板 引 
擎 。 因 为 这 里 没什么 额外 数据 要 传 给 模板 ， 所 以 使 用 一 个 空 字典 。 


8.5 自 定义 模板 标签 


如 果 能 在 每 个 页 面 的 侧 边栏 中 展示 有 哪些 分 类 可 浏览 就 好 了 。 根 据 目前 所 学 ， 这 个 想法 可 以 这 样 
实现 ; 


Q Æ base. htm 模板 中 添加 一 些 代码 ， 显 示 分 类 列表 


98 -第 8 章 模板 进 阶 


J 在 每 个 视图 中 通过 Category 对 象 获取 所 有 分 类 ， 通 过 上 下 文字 典 传 给 模板 


可 是 这 样 的 实现 方式 非常 不 好 ， 因 为 我 们 要 在 所 有 视图 中 重复 添加 相同 的 代码 。 为 了 不 违背 DRY 
原则 ， 我 们 可 以 自 定 义 模板 标签 ， 把 相关 的 操作 封装 起 来 。 


定义 模板 标签 


PVE rango/templatetags 目录 ， 然 后 在 其 中 新 建 两 个 模块 :一 个 命名 为 _init py, ARAB, A 
一 个 命名 为 rango_template_tags.py， 写 入 下 述 代 码 。 


from django import template 


N e 


from rango.models import Category 


4 register = template.Library() 


6 @register.inclusion_tag('rango/cats.html') 


~ 


def get_category_list(): 
8 return {'cats': Category.objects.all()} 


这 段 代 码 定 义 了 一 个 名 为 get_category_ Vitg 的 函数 ， 返 回 结果 为 分 类 列表 。 但 是 从 
register.inclusion_tag() 装饰 器 可 以 看 出 ， 这 个 函数 需要 rango/cats html 模板 的 支持 。 创 建 这 个 
模板 ， 写 人 下 述 HTML 标记 。 


1 <ul> 

2 {% if cats %} 

3 {% for c in cats %} 

4 <li><a href="{% url 'show_category' c.slug %}">{{ c.name }}</a></li> 
5 {% endfor %} 

6 {% else %} 

7 <li><strong>There are no categories present.</strong></li> 

8 {% endif %} 

9 </ul> 


为 了 在 base.html 模板 中 使 用 这 个 模板 标签 ， 首先 要 在 文件 顶部 添加 {% load rango_template_tags 
关 。 然 后 创建 一 个 区 块 ， 表 示 侧 边栏 。 在 侧 边 栏 中 通过 下 述 代码 调用 我 们 自 定义 的 模板 标签 


<div> 
{% block sidebar_block %} 
{% get_category_list %} 
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{% endblock %} 
</div> 


试 试看 。 现 在 继承 自 base himl 模板 的 每 个 页 面 都 将 显示 分 类 列表 〈 稍 后 移 到 侧 边 ) 。 


E 重启 服务 器 力 


修改 模板 标签 后 要 重启 Django 开发 服务 顺 ， 和 否则 Django 不 会 注册 新 标签 。 


参数 化 模板 标签 


为 了 提高 灵活 性 ， 可 以 参数 化 模板 标签 。 举 个 例子 : 突出 显示 当前 查看 的 分 类 。 添 加 参数 很 简 
单 ， 参 照 下 述 代码 修改 get_category_list() 函数 。 


def get_category_list(cat=None): 
return {'cats': Category.objects.all(), 
‘act_cat': cat} 


JER, cat 参数 是 可 选 的 ， 如 果 未 传人 ， 默 认为 None。 
接 下 来 修改 base.himl 模板 ,传人 当前 查看 的 分 类 ( 仪 当 存 在 时 ) 。 


<div> 
{% block sidebar_block %} 
{% get_category_list category %} 
{% endblock %} 
</div> 


此 外 ， 还 要 修改 cats html, 


{% for c in cats %} 

{% if c == act_cat %} 
<li> 
<strong> 

<a href="{% url 'show_category' c.slug %}">{{ c.name }}</a> 

</strong> 
</li> 

{% else %} 


<li> 
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<a href="{% url 'show_category' c.slug %}">{{ c.name }}</a> 
</li> 
{% endif %} 
{% endfor %} 


这 里 我 们 检查 显示 的 分 类 与 for 循环 当前 遍历 的 分 类 是 否 相同 (c == act_cat) ， 如 果 相 同 ， 通 
过 <strong> 标签 加 粗 ， 突 出 显示 当前 查看 的 分 类 名 。 


8.6 小 结 
本 章 讨论 了 下 述 内 容 : 


a 使 用 url 模板 标签 避免 硬 编 码 URL 
口 借助 模板 继承 减少 样板 代码 量 
1 通过 自 定 义 模 板 标签 减少 视图 中 重复 的 代码 


经 过 这 些 改进 之 后 ， 模 板 代 码 比 以 前 更 简洁 ， 也 更 易 维护 了 。 当 然 ，Django 模板 的 功能 还 有 很 
多 ， 详 情 参阅 Django 文档 。 
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* fem x 


J 先 重 构 about.html 模板 。 
) 更 新 每 个 模板 中 的 title_block 和 body_block 区 块 。 


J 在 修改 的 过 程 中 始终 运行 着 开发 服务 器 ， 随 时 检查 改动 后 的 页 面 。 不 要 改 完 之 后 再 检 
查 。 边 改 边 测试 更 安全 。 


T 若 想 指向 某 个 分 类 的 页 面 ， 可 以 使 用 下 述 模 板 代码 。 请 留意 其 中 的 {% url %} 命令 。 


<a href="{% url 'show category' category.slug %}">{{ category.name }}</a> 
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用 户 身 份 验证 


接 下 来 的 三 章 为 您 介绍 Django 提供 的 用 户 身 份 验证 机 制 。 我 们 将 使 用 django.contrib.auth 包 中 


的 auth 应 用 。 根 据 Django 文档 ， 


这 个 应 用 提供 了 下 述 概念 和 功能 : 


2 用 户 和 用 户 模型 

J 权限 ， 判 断 用 户 可 以 做 什么 及 不 可 以 做 什么 的 旗 标 (是 / 否 ) 
2 用 户 组 ， 把 相关 权限 一 次 赋予 多 个 用 户 

1 可 配置 的 密码 哈 希 系统 ， 保 证 数据 安全 不 可 或 缺 

J 登录 或 限制 性 内 容 所 需 的 表单 和 视图 


在 用 户 身 份 验证 方面 ，Django 提供 了 足够 的 机 制 。 本 章 介绍 基础 知识 ， 让 你 了 解 可 用 的 工具 和 底 


9.1 设置 身份 验证 


在 使 用 Django 提供 的 号 份 验证 机 


il ZA, ZEN HH settings.py 文件 中 添加 相关 的 设置 。 


在 settings py 文件 中 找到 INSTALLED_APPS 列表 ， 检 查 有 没有 列 出 django.contrib.auth 和 
django.contrib.contenttypes, INSTALLED_APPS 列表 应 该 类 似 下 面 这 样 : 


INSTALLED_APPS =[ 
'django.contrib.admin', 
'django.contrib.auth', 
'django.contrib.content 
'django.contrib.session 
'django.contrib.message 
'django.contrib.staticf 


types', 
a; 
S"; 
iles', 
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"rango', 


] 


django.contrib.auth 用 于 访问 Django 提供 的 身份 验证 系统 ， 而 django.contrib.contenttypes ft 
auth 应 用 跟踪 数据 库 中 的 模型 。 


大 如 有 必要 ， 迁 移 x 


如 果 INSTALLED_APPS 列表 中 没有 django.contrib.auth 和 django.contrib.contenttypes， 要 
自己 添加 ， 添 加 后 还 要 执行 python manage.py migrate 命令 更 新 数据 库 ， 添 加 所 需 的 表 ， 例 
如 User 模型 的 表 。 


在 Django 项 目 中 添加 新 的 应 用 后 ， 一 般 最 好 执行 migrate 命令 ， 以 防 应 用 中 有 模型 要 与 底 
层 数 据 库 同步 。 


9.2 密码 哈 希 


任何 情况 下 都 不 能 在 数据 库 中 存储 明文 密码 。! 如 果 包 含 用 户 账户 的 数据 库 落 到 不 怀 好 意 的 人 手 
上 ， 可 能 造成 天 大 的 灾难 。 幸 好 ，Django 的 auth 应 用 默认 存储 的 是 经 过 PBKDF2 算法 计算 过 的 
密码 哈 希 值 ， 可 以 有 效 保护 用 户 数据 的 安全 。 然 而 ， 如 果 你 想 进 一 步 控制 生成 密码 哈 希 值 的 方 
式 ， 可 以 在 项 目的 settings py 模块 中 更 换 Django 使 用 的 算法 。 为 此 ， 添 加 PASSWORD_HASHERS 元 
组 ， 例 如 : 


PASSWORD_HASHERS = ( 
‘django.contrib.auth.hashers.PBKDF2PasswordHasher', 
‘django.contrib.auth.hashers.PBKDF2SHA1PasswordHasher', 

) 


罗列 哈 希 算法 的 顺序 很 重要 ，Django 将 使 用 PASSWORD_HASHERS 中 的 第 一 个 哈 希 算法 
(settings.PASSWORD_HASHERS[0]) 。 如 果 第 一 个 无 效 ， 而 且 还 有 其 他 哈 希 算法 供 选 择 ，Django 
将 依次 尝试 后 面 的 算法 。 


如 果 想 使 用 更 为 安全 的 哈 希 算法 ， 可 以 安装 Berypt (pip install bcrypt) ， 然 后 把 
PASSWORD_HASHERS 设 为 : 


1. https://stackoverflow.com/q/1197417 
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PASSWORD_HASHERS = [ 
"django.contrib.auth.hashers.BCryptSHA256PasswordHasher', 
‘django.contrib.auth.hashers.BCryptPasswordHasher', 
'django.contrib.auth.hashers.PBKDF2PasswordHasher', 
‘django.contrib.auth.hashers.PBKDF2SHA1PasswordHasher', 


] 


前 面 说 过 ，Django 默认 使 用 PBKDF2 算法 计算 密码 哈 希 值 。 如 果 未 在 settings py 文件 中 设 定 
PASSWORD_HASHERS, Django 将 使 用 默认 的 PBKDF2PasswordHasher。 详 情 参见 Django 文档 。 


9.3 密码 验证 器 


鉴于 人 们 经 常 使 用 相对 容易 猜 出 的 密码 ，Django 1.9 引入 了 一 个 备 受 期 待 的 新 功能 一 一 密码 验 
WE. Æ Django 项 目的 settings py 模块 中 有 个 字典 构成 的 列表 ， 名 为 AUTH_PASSWORD_VALIDATORS 。 
在 藤 套 的 字典 中 可 以 清楚 地 看 出 ，Django 1.9 自 带 了 一 些 常 用 的 密码 验证 器 ， 例 如 针对 长 度 的 验 
证 器 。 每 个 验证 器 都 有 OPTIONS 字典 ， 以 便 自 定义 选项 。 假 如 你 想 确保 密码 最 短 为 6 个 字符 ， 那 
入 可 以 把 MinimumLengthValidator 的 min_length 选项 设 为 6， 如 下 所 示 : 


AUTH_PASSWORD_VALIDATORS = [ 


"NAME': 'django.contrib.auth.password_validation.MinimumLengthVaLlidator', 
‘OPTIONS': { 'min_length': 6, } 
b 


] 


除了 自 带 的 密码 验证 器 之 外 ， 还 可 以 自 定 义 。 本 书 不 介绍 具体 方法 ， 如 果 感 兴趣 ， 请 阅读 Django 
文档 。 


9.4 User 模型 


User 对 象 (django.contrib.auth.models.User) 是 Django 身份 验证 系统 的 核心 ， 表 示 与 Django 
应 用 交互 的 每 个 个 体 。 根 据 Django 文档 ， 身 份 验证 系统 的 很 多 方面 都 能 用 到 User 对 象 ， 例 如 访 
间 限 制 、 注 册 新 用 户 ， 以 及 网 站 内 容 与 创建 者 之 间 的 关系 。 


User 模型 有 5 个 主要 属性 : 
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用 户 账户 的 用 户 名 (username) 
用 户 账 户 的 密码 (password) 
用 户 的 电子 邮件 地 址 (email) 
用 户 的 名 字 (first_nanme) 

用 户 的 姓 (Last_name) 


Wee U O 


此 外 ，User 模型 还 有 其 他 属性 ， 例 如 is active, is_staff 和 is_superuser。 这 些 属性 的 值 都 是 
布尔 值 ， 分 别 用 于 指明 账户 是 否 激活 、 是 否 为 团队 成 员 ， 以 及 是 否 拥有 超级 用 户 权 限 。User 模型 
的 完整 属性 列表 参阅 Django 文档 。 


9.5 增加 用 户 属 性 


除了 User 模型 提供 的 属性 之 外 ， 如 果 还 需要 其 他 用 户 相关 的 属性 ， 要 自己 定义 一 个 与 User 模型 
关联 的 模型 。 对 Rango 应 用 而 言 ， 我 们 想 为 用 户 账户 增加 两 个 属性 : 


I 一 个 URLField， 让 Rango 的 用 户 设 定 自 己 的 网 站 
I 一 个 ImageFieLd， 让 Rango 的 用 户 设 定 自己 的 头像 


为 此 ， 要 在 Rango 应 用 的 models py 文件 中 定义 一 个 模型 。 我 们 把 这 个 模型 命名 为 UserProfile。 


class UserProfile(models.Model): 
# 这 一 行 是 必须 的 
# 建立 与 User 模型 之 间 的 关系 
user = models.OneToOneField(User ) 


# 想 增加 的 属性 
website = models.URLField(blank=True) 
picture = models.ImageField(upload_to='profile_images', blank=True) 


# BZ str_() 方法 ， 返 回 有 意义 的 字符 事 
# 如 果 使 用 Python 2.7.x， 还 要 定义 _ unicode_ _ 方法 
def _str_ (self): 


return self.user.username 


注意 ， 这 个 模型 与 User 模型 之 间 建 立 的 一 对 一 关系 。 因 为 引用 了 默认 的 User 模型 ， 所 以 要 在 
models py 文件 中 导入 它 : 
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from django.contrib.auth.models import User 


我 们 为 Rango 应 用 的 用 户 账 户 增加 了 两 个 字段 ， 还 提供 了 _str__() 方法 ， 以 便 在 需 
UserProfile 实例 的 字符 串 表 示 形 式 时 返回 有 意义 的 值 。 注 意 ， 使 用 Python 2 的 话 ， 还 要 定义 
__unicode__() 方法 ， 返 回 用 户 名 的 Unicode 格式 。 


我 们 增加 的 website 和 picture 字段 都 设 定 了 blLank=True。 因 此 这 两 个 字段 都 可 以 为 空 ， 不 是 必 
须要 提供 值 。 


此 外 ， 注 意 ImageField 字段 的 upload_to 参数 。 这 个 参数 的 值 与 项 目的 MEDIA_ROOT 设置 (第 4 
章 ) 结合 在 一 起 ,确定 上 传 的 头像 存储 在 哪里 。 假 如 MEDIA_ROOT 的 值 为 
<workspace>/tango_with_django_project/media/, upload_to 参数 的 值 为 profiLe_images， 那 么 头 
像 将 存储 在 <workspace>/tango_with_django_project/media/profile_images/ 目录 中 。 


加 能 通过 继承 扩展 吗 ? m 


你 可 能 想 通 过 继承 User 模型 增加 字段 ， 但 是 考虑 到 其 他 应 用 或 许 也 会 访问 User 模型 ， 因 此 
不 建议 使 用 继承 ， 而 是 推荐 在 数据 库 中 建立 一 对 一 关系 。 


Django 的 ImageField 字段 要 使 用 Python Imaging Library (PIL) 。 如 果 你 还 未 安装 ， 执 行 
pip install pillow 命令 ， 通 过 pip 安装 PIL。 如 果 未 启用 JPEG 支持 ， 也 可 以 安装 PIL: 
pip install pillow --global-option="build_ext" --global-option="--disable- jpeg", 


若 想 查看 (虚拟 ) 环境 中 安装 了 哪些 包 ， 执 行 pip list 命令 。 


如 果 想 通过 Django 管理 界面 访问 UserProfile 模型 数据 ， 在 Rango 应 用 的 admin py 模块 中 导入 
UserProfile 模型 ; 


from rango.models import UserProfile 
然后 注册 模型 : 


admin.site.register(UserProfile) 
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x Alls Tit x 


ETRY aD aR, AST) 在 终端 或 命令 提示 符 中 执行 python manage. py 


makemigrations rango 命令 ， 为 新 增 的 UserProfile 模型 创建 迁移 脚本 。 然 后 执行 python 
manage.py migrate 命令 ， 运 行 迁 移 ， 在 底层 数据 库 中 创建 相关 的 表 。 


9.6 创建 用 户 注 册 视 图 和 模板 


一 切 准 备 妥 当 之 后 ， 接 下 来 实现 用 户 注册 功能 。 为 此 ， 我 们 要 定义 一 个 新 视图 、 创 建 一 个 模板 ， 
并 添加 一 个 URL 映射 。 


E 现成 的 用 户 注册 应 用 m 


注意 ， 有 一 些 现成 的 用 户 注 册 应 用 可 以 拿 来 直接 使 用 ， 无 需 我 们 自己 动手 实现 注册 和 登录 功 


然而 ， 在 使 用 这 样 的 应 用 之 前 最 好 了 解 一 下 底层 机 制 。 没 有 痛苦 就 没有 收获 。 在 这 个 过 程 中 
还 能 巩固 你 对 表单 的 理解 ， 学 会 如 何 扩 展 User 模型 ， 以 及 如 何 上 传媒 体 文件 。 


实现 用 户 注册 功能 的 步骤 如 下 : 


定义 UserForm 和 UserProfileForm 

添加 一 个 视图 ， 处 理 创 建新 用 户 的 过 程 
创建 一 个 模板 ， 显 示 UserForm 和 UserProfileForm 
把 URL 映射 到 前 面 添加 的 视图 上 


U O O vo 


最 后 ， 还 要 在 首页 添加 一 个 链接 ， 指 向 注册 页 面 。 


定义 UserForm 和 UserProfileForm 


我 们 要 在 rango/forms py 中 定义 两 个 类 ， 继 承 自 forms.ModeLForm。 其 中 一 个 针对 User 类 ， 男 一 个 
针对 前 面 定 义 的 UserProfile 模型 。 这 两 个 ModelForm 子 类 创建 的 HTML 表单 用 于 显示 相应 模型 
的 字段 ， 为 我 们 节省 了 很 多 工作 量 。 


首先 ， 在 rango/forms py 文件 中 定义 两 个 继承 自 forms .ModeLForm 的 类 。 
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class UserForm(forms.ModelForm): 
password = forms.CharField(widget=forms.PasswordInput()) 


class Meta: 
model = User 
fields = ('username', ‘email', 'password') 


class UserProfileForm(forms.ModeLForm): 
class Meta: 
model = UserProfile 
fields = ('website', 'picture') 


注意 ， 这 两 个 类 中 都 有 Meta 类 。 如 其 名 所 示 ，Meta 类 的 作用 是 为 所 在 的 类 提供 额外 的 属性 。Meta 
类 中 必须 有 model Ez, UserForm 类 对 应 的 模型 是 User。 此 外 ， 还 要 通过 fields 或 exclude 指定 
要 在 表单 中 显示 或 排除 的 字段 。 


这 里 ， 我 们 只 想 显 示 User 模型 的 username, email 和 password 字段 ， 以 及 UserProfile 模型 的 
website 和 picture PZ, UserProfile 模型 的 user 字段 在 注册 用 户 时 设 定 。 这 是 因为 创建 
UserProfile 实例 时 ， 还 没有 User 实例 可 用 。 


此 外 ， 注意 UserForm 中 定义 了 password 属性 。 虽 然 User 模型 实例 有 password 属性 ， 但 是 在 泻 染 
的 HTML 表单 中 这 个 字段 的 值 不 会 被 遮盖 ， 用 户 输入 的 密码 是 可 见 的 。 鉴 于 此 ， 我 们 重新 定义 了 
password 属性 ， 指 定 使 用 PasswordInput() 小 组 件 显示 这 个 CharFieLd， 以 防 用 户 输入 的 密码 被 人 
RL. 


Ua, a SE forms py 模块 的 顶部 导入 所 需 的 类 。 为 了 便于 你 参考 ， 下 面 给 出 导入 语句 : 
from django import forms 


from django.contrib.auth.models import User 
from rango.models import Category, Page, UserProfile 


定义 register() 视图 


接 下 来 要 泻 染 表单 及 处 理 表单 数据 。 在 Rango 应 用 的 views py 模块 中 ， 添 加 一 个 import 语句 ， 导 
入 新 定义 的 UserForm 和 UserProfileForm 类 。 


from rango.forms import UserForm, UserProfileForm 


然后 定义 register() 视图 : 
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def register(request): 
# 一 个 布尔 值 ， 告 诉 模板 注册 是 否 成 功 
# 一 开始 设 为 Fatse， 注 册 成 功 后 改 为 True 
registered = False 


# 如 果 是 HTTP POST 请 求 ， 处 理 表单 数据 

if request.method == 'POST': 
# 尝试 获取 原始 表单 数据 
# 注意 ，UserForm 和 UserProfileForm 中 的 数据 都 需要 
user_form = UserForm(data=request.POST) 
profile_form = UserProfileForm(data=request. POST) 


# 如 果 两 个 表单 中 的 数据 是 有 效 的 .… 

if user_form.is valid() and profile_form.is_valid(): 
# 把 UserForm 中 的 数据 存 入 数据 库 
user = user_form.save() 


# 使 用 set_password 方法 计算 密码 哈 希 值 
# 然后 更 新 User 对 象 

User .set_password(user .password) 
user.save() 


# 现在 处 理 UserProfile 实例 

# 因为 要 自行 处 理 user 属性 ， 所 以 设 定 commit=False 
# 延迟 保存 模型 ， 以 防 出 现 完 整 性 问题 

profile = profile form.save(commit=False) 
profile.user = user 


H 用 户 提供 头像 了 吗 ? 
# 如 果 提 供 了 ， 从 表单 数据 库 中 提取 出 来 ， 赋 给 UserProfile 模型 
if 'picture' in request.FILES: 

profile.picture = request.FILES[ 'picture' ] 


# 保存 UserProfile 模型 实例 
profile. save() 


# 更 新 变量 的 值 ， 告 诉 模板 成 功 注 册 了 
registered = True 
else: 


# 表单 数据 无 效 ， 出 错 了 ? 
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# 在 终端 打印 问题 
print(user_form.errors, profile form.errors) 
else: 
# 不 是 HTTP POST HR, AA ModelForm 实例 
# 表单 为 空 ， 待 用 户 填写 
user_form = UserForm() 
profile_form = UserProfileForm() 


# ARSE LF Cig RRR 
return render(request, 
'rango/register.html', 
{'user_form': user_form, 
'profile_form': profile_form, 
'registered': registered}) 


这 个 视图 看 似 复杂 ， 其 实 与 添加 分 类 和 添加 网 页 的 视图 十 分 相似 。 这 里 ， 我 们 要 处 理 两 个 不 同 的 
ModelForn 实例 ， 一 个 针对 User 模型 ， 一 个 针对 UserProfile 模型 。 如 果 用 户 上 传 了 头像 ， 还 要 
处 理 头 像 图 片 。 


此 外 ， 还 要 建立 两 个 模型 实例 之 间 的 关系 。 为 此 ， 我 们 先 创建 User 模型 实例 ， 然 后 在 
UserProfile 实例 中 引用 它 : profile.user = user, UserProfileForm 表单 的 user 属性 必须 这 样 设 
定 ， 不 能 让 用 户 自行 填写 。 

创建 注册 页 面 的 模板 

现在 要 创建 register() 视图 的 模板 。 新 建 rango/register. html 文件 ， 写 人 下 述 代码 。 


{% extends 'rango/base.html' %} 
{% load staticfiles %} 


N e 


4 {% block title_block %} 
5 Register 

6 {% endblock %} 

7 


8 {% block body_block %} 
9 <hi>Register for Rango</hi> 


10 {% if registered %} 
11 Rango says: <strong>thank you for registering!</strong> 
12 <a href="{% url ‘index! %}">Return to the homepage.</a><br /> 


9.6 创建 用 户 注册 视图 和 模板 - 111 


13 {% else %} 


14 Rango says: <strong>register here!</strong><br /> 

15 <form id="user_form" method="post" action="{% url 'register' %}" 
16 enctype="muLltipart/form-data"> 

17 

18 {% csrf_token %} 

19 

20 <!-- 显示 每 个 表单 --> 

21 {{ user_form.as_p }} 

22 {{ profile_form.as p }} 

23 

24 <!-- 提供 一 个 按钮 ， 点 击 后 提交 表单 --> 

25 <input type="submit" name="submit" value="Register" /> 
26 </form> 

27 {% endif %} 


28 {% endblock %} 


x 使 用 url 模板 标签 k 


注意 ， 上 述 模板 中 使 用 了 url 模板 标签 ， 例 如 {% url 'register' 时。 因此， 后面 添加 的 


URL 映射 要 命名 为 register, 


注意 ， 这 个 模板 使 用 视图 中 的 registered 变量 判断 注册 是 否 成 功 。registered 的 值 为 False Hy, 
显示 注册 表单 ， 否则 ， 显 示 成 功 注册 消息 。 


此 外 ， 我 们 在 user_form 和 profile_form 上 调用 了 as_p 模板 函数 。 这 么 做 的 目的 是 在 段落 
(HTML <p> 标签 ) 中 显示 各 个 表单 元 素 ， 一 行 显示 一 个 表单 元 素 。 


最 后 注意 ， 我 们 为 <form 元 素 设 定 了 enctype 属性 。 这 是 因为 ， 如 果 用 户 想 上 传 头像 ， 表 单数 据 
中 将 包含 二 进 制 数据 ， 而 且 可 能 相当 大 。 传 给 服务 器 时 ， 这 些 数 据 要 分 成 几 部 分 。 因 此 ， 我 们 要 
设 定 enctype="multipart/form-data"， 让 HTTP 客户 端 (Web 浏览 器 ) 分 段 打 包 和 发 送 数据 。 如 
若 不 然 ， 服 务 器 收 不 到 用 户 提交 的 全 部 数据 。 


© 分 段 报 文 和 二 进 制 文件 多 


注意 <form> 元 素 的 enctype 属性 。 如 果 想 让 用 户 通过 表单 上 传 文件 ， 必 须 把 enctype 属性 设 


112 -第 9 章 用 户 身份 验证 


为 mutLtipart/form-data。 这 样 设 定 后 ， 浏 览 器 会 以 特殊 的 方式 发 送 表 单数 据 。 说 白 了 ， 就 
是 把 表示 文件 的 数据 分 成 多 个 小 块 ， 然 后 发 送 。 详 情 参 见 Stack Overflow 网 站 中 这 个 优秀 的 


回答 。 


此 外 ， 别 乐 了 在 表单 中 添加 CSRF 令 牌 ， 即 {% csrf_token %}, mW, Django 的 路 站 请 求 伪 造 保 
护 中 间 件 将 拒绝 接收 表单 的 内 容 ， 返 回 错误 。 


添加 URL 映射 


有 了 视图 和 对 应 的 模板 之 后 ， 现 在 可 以 添加 URL 映射 了 -。 打 开 Rango 应 用 的 urls py 模块 ， 根 据 
下 述 代码 修改 urlpatterns, 


urlpatterns = [ 
url(r'^$', views.index, name='index'), 
url(r'about/$', views.about, name='about'), 
url(r'*add_category/$', views.add_category, name='add_category'), 


url(r'“category/(?P<category_name_slug>[\w\-]+)/$', 
views.show_category, 
name='show_category'), 


url(r'“category/(?P<category_name_slug>[\w\- ]+)/add_page/$', 
views.add_ page, 
name='add_page'), 


url(r'4register/$', 
views.register, 
name='register'), # 新 增 的 模式 
] 


新 增 的 模式 把 /rango/register/ URL 映射 到 register) 视图 上 。 注 意 ， 我 们 为 这 个 新 模式 设 定 了 
name 参数 ， 以 便 在 模板 中 使 用 url 引用, 例如 { url ‘register’ %}, 


添加 链接 


最 后 ， 在 base.html 模板 中 添加 一 个 链接 ， 指 向 注册 页 面 。 参 照 下 述 代 码 更 新 无 序列 表 中 的 链接 ， 
在 Rango 应 用 的 每 个 页 面 中 都 添加 指向 注册 页 面 的 链接 。 
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<ul> 
<li><a href="{% url ‘add_category' %}">Add a New Category</a></li> 
<li><a href="{% url 'about' %}">About</a></li> 
<li><a href="{% url 'index' %}">Index</a></li> 
<li><a href="{% url 'register' %}">Register Here</a></li> 
</ul> 


检验 结果 


一 切 就 绪 之 后 ， 该 检验 结果 了 。 局 动 Django 开发 服务 器 ， 注 册 一 个 用 户 试 试 。 如 果 愿 意 ， 上 传 一 
个 头像 。 注 册 表 单 如 图 9-1 所 示 。 


6 O@ / [M rango 
€ CC | 127.0.0.1:8000/rango/register/ Oraga 


Register with Rango 


Rango says: register here! Click here to go to the homepage. 
] Required. 30 characters or fewer. Letters, numbers and @/./+/-/_ characters 


Picture: | Choose File | No file chosen 


Register | 


A 9-1: 注册 表单 
看 到 成 功 注册 消息 后 ，User 和 UserProfile 模型 在 数据 库 中 应 该 都 会 增加 一 条 记录 。 在 Django 管 
理 界面 中 确认 是 不 是 这 样 。 
9.7 实现 登录 功能 
用 户 能 注册 账户 之 后 ， 接 下 来 要 让 用 户 能 够 登录 。 为 此 ， 要 执行 以 下 几 步 : 


J 定义 一 个 视图 ， 处 理 登 录 赁 据 
J 创建 一 个 模板 ， 显 示 登 录 表 单 
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J 把 登录 视图 映射 到 一 个 URL 上 
在 首页 添加 登录 链接 


定义 登录 视图 


首先 ， 打 开 Rango 应 用 的 views py 模块 ， 定 义 一 个 新 视图 ， 名 为 user_Login()。 这 个 视图 负责 处 
理 登 录 表单 提交 的 数据 ， 以 及 登入 用 户 。 


def user_login(request): 

# 如 果 是 HTTP POST 请 求 ， 党 试 提取 相关 信息 

if request.method == 'POST': 
# 获取 用 户 在 登录 表单 中 输入 的 用 户 名 和 密码 
# 我 们 使 用 的 是 request.P0ST.get('<variabLe> ') 
# 而 不 是 request.POST[ '<variable>' ] 
# 这 是 因为 对 应 的 值 不 存在 时 ， 前 者 返回 None， 
# 而 后 者 抛 出 KeyError 异常 
username = request.POST.get('username') 
password = request.POST.get('password') 


# 使 用 Django 提供 的 函数 检查 username/password 是 否 有 效 
# 如 果 有 效 ， 返 回 一 个 User 对 象 
user = authenticate(username=username, password=password) 


# 如 果 得 到 了 User 对 象 ， 说 明 用 户 输入 的 凭据 是 对 的 
# 如 果 是 None (Python 表示 没有 值 的 方式 ) ,说 明 没 找到 与 任 据 匹配 的 用 户 
if user: 
H 账户 激活 了 吗 ? 可 能 被 禁 了 
if user.is_active: 
# 登入 有 效 且 已 激活 的 账户 
# 然后 重 定向 到 首页 
login(request, user) 
return HttpResponseRedirect(reverse('index')) 
else: 
# 账户 未 激活 ， 禁 止 登录 
return HttpResponse("Your Rango account is disabled.") 
else: 
# 提供 的 登录 凭据 有 问题 ， 不 能 登录 
print("Invalid login details: {0}, {1}".format(username, password)) 
return HttpResponse("Invalid login details supplied.") 
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# 不 是 HTTP POST 请 求 ， 显 示 登 录 表 单 
# 极 有 可 能 是 HTTP GET 请 求 
else: 
# 没什么 上 下 文 变 量 要 传 给 模板 系统 
# 因此 传 入 一 个 空 字 典 
return render(request, 'rango/login.html', {}) 


跟 之 前 一 样 ， 同 的 情况 ， AAA Ne 从 上 述 代码 可 以 看 出 ， 
user_login() 视图 既 能 泻 染 登 录 表单 (包含 username 和 password 两 个 字段 ) ， 也 能 处 理 表 单数 
据 。 


如 果 通 过 HTTP GET 方法 访问 这 个 视图 ， 显 示 登 录 表 单 。 然 而 ， 如 果 通 过 HTTP POST 请 求 访 
问 ， 则 处 理 表单 数据 。 


如 果 通 过 POST 请 求 发 送 有 效 的 表单 数据 ， 从 中 提取 用 户 名 和 密码 。 然 后 使 用 Django 提供 的 
authenticate() 函数 检查 用 户 名 和 密码 是 否 匹 配 某 个 用 户 账户 。 如 果 能 找到 这 样 的 用 户 ， 返 回 一 
个 User 对 象 ， 否 则 返回 None, 


返回 User 对 象 时 ， 检 查账 户 是 否 激活 。 如 果 是 激活 的 ， 调 用 Django 提供 的 Login() 函数 ， 登 入 
用 户 。 


然而 ， 如 果 发 送 的 表达 数据 无 效 ， 例 如 用 户 名 和 密码 没有 都 填 ， 登 录 表 单 显示 错误 消息 ， 提 示 用 
户 名 或 密码 无 效 。 


你 可 能 注意 到 了 ， 这 里 用 了 一 个 新 类 ， 即 HttpResponseRedirect。 从 名 称 可 以 看 出 ， 
HttpResponseRedirect 实例 生成 的 啊 应 让 Web N bi at Be xe [a] BIBER EY URL。 注 意 ， 啊 应 的 
HTTP 状态 码 是 表示 重 定向 的 302， 而 不 是 表示 成 功 的 200。 详 情 参见 Django 文档 。 


最 后 ， 使 用 Django 提供 的 reverse() 函数 获取 Rango 应 用 首页 的 URL, reverse() 函数 在 Rango 
应 用 的 urls py 模块 中 查找 名 为 index 的 URL 模式 ， 解 析出 对 应 的 URL。 如 果 以 后 修改 了 URL 映 
射 ， 视 图 代码 不 受 影响 。 


user_login() 视图 用 到 了 Django 提供 的 多 个 函数 和 类 ， 因 此 要 导入 它们 。 下 述 import 语句 必须 
放 在 rangolviews py 文件 的 顶部 。 


from django.contrib.auth import authenticate, Login 
from django.http import HttpResponseRedirect, HttpResponse 
from django.core.urlresolvers import reverse 
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创建 登录 页 面 的 模板 


有 了 视图 之 后 ， 我 们 还 要 创建 一 个 模板 ， 让 用 户 输入 登录 凭据 。 现 在 你 应 该 知道 要 把 模板 放 在 
templates/rango/ 目录 中 ， 不 过 这 个 模板 的 名 称 我 不 告诉 你 ， 请 你 根据 user_login() 视图 的 代码 确 
定 。 在 模板 中 写 入 下 述 代码 : 


{% extends 'rango/base.html' %} 
{% load staticfiles %} 


{% block title_block %} 
Login 
{% endblock %} 


{% block body_block %} 

<hi>Login to Rango</h1i> 

<form id="Login_form" method="post" action="{% url 'Login' %}"> 
{% csrf_token %} 
Username: <input type="text" name="username" value= 
<br /> 
Password: <input type="password" name="password" value= 
<br /> 
<input type="Submit" value="submit" /> 


size="50" /> 


size="50" /> 


</form> 
{% endblock %} 


input 元 素 的 name 属性 要 与 user_login() 视图 中 的 保持 一 致 。 也 就 是 说 ， 用 户 名 输入 框 的 name 
属性 的 值 应 该 是 username， 而 密码 输入 框 的 name 属性 的 值 应 该 是 password。 此 外 ， 别 忘 了 {% 


csrf_token %}, 


添加 URL 映射 


创建 好 登录 模板 之 后 ， 接 下 来 要 把 user_Login() 视图 映射 到 一 个 URL 上 。 修 改 Rango 应 用 的 
urls py 模块 ， 在 urlpatterns 列表 中 添加 下 述 映射 


url(r'^login/$', views.user_login, name='login'), 
添加 链接 
最 后 ， 添 加 一 个 链接 ， 方 便 Rango 的 用 户 访问 登录 页 面 。 编 辑 templates/rango/ 目录 中 的 base.html 
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模板 ， 在 无 序列 表 中 添加 下 述 链接 : 


<ul> 


<li><a href="{% url 'login' %}">Login</a><li> 
</ul> 


如 果 愿 意 ， 还 可 以 修改 首页 的 页 头 ， 向 已 登录 的 用 户 显示 独特 的 欢迎 消息 ， 而 未 登录 的 用 户 则 显 
示 一 般 的 欢迎 消息 。 在 index.html 模板 中 找到 现在 的 欢迎 消息 : 


hey there partner! 
把 这 一 行 改 成 : 


{% if user.is_authenticated %} 
howdy {{ user.username }}! 
{% else %} 
hey there partner! 
{% endif %} 


可 以 看 出 ， 我 们 使 用 {% if user.is_authenticated %} 检查 用 户 是 否 通过 身份 验证 。 如 果 用 户 已 
登录 ， 我 们 能 访问 user 对 象 。 因 此 ， 我 们 可 以 通过 这 个 对 象 判断 用 户 是 否 登 录 〈 验 证 身份 ) 。 如 
果 用 户 已 登录 ， 我 们 便 能 获取 关于 用 户 的 更 多 信息 。 在 这 个 示例 中 ， 当 用 户 登 录 后 ， 我 们 获取 用 
户 的 用 户 名 。 如 果 用 户 未 登录 ， 则 显示 一 般 的 欢迎 消息 ， 即 “hey there partner!”。 


检验 结果 


启动 Django 开发 服务 器 ， 尝 试 登录 。 登 录 前 后 首页 的 截图 见 图 9-2, 


8 98 / [M rango 一 
€ > Œ [Q 127.0.0.1:8000/rango/ even 


BAB M rano 


€ > Œ D 127.0.0.1:8000/rango/ Oren 


Rango says..hello world! Rango says..hello somebody! 


。 home e home 
e sport e sport 
e fun 。 fun 


Add a New Category 
Register Here 
Ton 


Add a New Category 
Register Here 
Lack 


图 9-2: 未 登录 的 首页 和 登录 后 的 首页 (用 户 名 为 "somebody”) 
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至 此 ， 用 户 登 录 功 能 可 用 了 。 请 启动 Django 开发 服务 器 ， 注 册 一 个 新 账户 试 试 。 成 功 注 册 后 ， 你 
应 该 能 使 用 自己 设 定 的 凭据 登录 。 


9.8 限制 访问 


现在 用 户 可 以 登录 Rango 应 用 了 ， 根 据 客 户 的 要 求 ， 接 下 来 应 该 限制 访问 应 用 的 某 些 页 面 ， 即 
有 注册 的 用 户 才 能 添加 分 类 和 网 页 。 在 Django 中 ， 这 一 要 求 有 多 种 实现 方式 。 


Dial 


J 在 模板 中 可 以 使 用 {% if user.authenticated %} 模板 标签 修改 页 面 渔 染 的 内 容 
J 在 视图 中 可 以 直接 通过 request 对 象 检 查 用 户 有 没有 通过 身份 验证 
J 此 外 ， 还 可 以 使 用 Django 提供 的 @login_required 装饰 器 检查 用 户 有 没有 通过 身份 验证 


第 二 种 方法 使 用 user .is_authenticated() 方法 。user 对 象 通过 传人 视图 的 request 对 象 访问 。 具 
体 方法 如 下 述 代码 所 示 : 


def some_view(request): 
if not request.user.is_authenticated(): 
return HttpResponse("You are Logged in.") 
else: 
return HttpResponse("You are not logged in.") 


第 三 种 方法 使 用 Python 装饰 顺 。 装 饰 器 根据 同名 软件 设计 模式 命名 ， 其 作用 是 在 不 修改 函数 、 方 
法 或 类 源码 的 基础 上 调整 函数 、 方 法 或 类 的 功能 。 


Django 提供 的 Login_required() 装饰 器 可 以 依附 在 任何 要 求 用 户 登 录 的 视图 上 。 如 果 未 登录 的 用 
户 尝 试 访问 使 用 login_required() 装饰 的 视图 ， 浏 览 器 会 重 定 向 到 另 一 个 页 面 ， 这 个 页 面 可 以 自 
己 设 定 ， 通 常 是 登录 页 面 。 


使 用 装饰 器 限制 访问 
举 个 例子 。 在 Rango 应 用 的 views py 模块 中 添加 一 个 视图 ， 名 为 restricted(): 


@login_required 
def restricted(request): 
return HttpResponse( "Since you're logged in, you can see this text!") 


ER, RAA 2 BCE AI LT, ER MAAA e E Python 会 
先 执 行 装饰 器 ， 再 执行 函数 〈 方 法 ) 的 代码 。 闭 饰 器 其 实 也 是 函数 ， 因 此 如 果 闭 饰 器 在 其 他 模块 
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中 ， 要 将 其 导入 。 因 为 login_required() 装饰 器 经 常 使 用 ， 所 以 views.py 模块 的 顶部 经 常 有 下 述 


import 语句 。 


from django.contrib.auth.decorators import login_required 
然后 在 Rango 应 用 的 urls py 模块 中 添加 一 个 URL 映射 : 


url(r'4restricted/', views.restricted, name='restricted'), 


此 外 ， 还 要 处 理 未 登录 的 用 户 尝试 访问 restricted() 视图 的 情况 。 此 时 应 该 怎么 做 呢 ? 最 简单 的 
处 理 方法 是 重 定向 到 他 们 能 访问 的 页 面 ， 例 如 登录 页 面 。 这 个 页 面 的 地 址 在 项 目的 settings py 模 

块 中 设 定 。 打 开 settings py 文件 ， 定 义 LOGIN_URL 变量 ， 把 值 设 为 未 登录 时 的 重 定 向 地 址 。 这 里 ， 
设 为 /rango/login/ URL 上 的 登录 页 面 : 


LOGIN_URL = '/rango/login/' 


这 样 设 定 后 ，login_required() 装饰 器 将 把 未 登录 的 用 户 重 定向 到 /rango/login/ URL, 


9.9 退出 

用 户 能 注册 和 登录 之 后 ， 还 要 能 退出 。Django 提供 的 logout() 函数 能 确保 用 户 正确 且 安 全 地 退 
出 。 用 户 的 会 话 结束 后 ， 如 果 再 想 访问 受 限 制 的 视图 ， 要 重新 登录 。 

为 了 提供 退出 功能 ， 打 开 rango/views py 文件 ， 添 加 名 为 user_Logout() 的 视图 ， 代 码 如 下 : 


# 使 用 Login_required() 装饰 器 限制 
# 只 有 已 登录 的 用 户 才 能 访问 这 个 视图 
@login_required 
def user_logout(request): 
# 可 以 确定 用 户 已 登录 ， 因 此 直接 退出 
logout(request) 
# 把 用 户 带 回首 页 
return HttpResponseRedirect(reverse('index')) 


别 忘 了 在 views py 模块 的 顶部 导入 Logout() KZŽ: 
from django.contrib.auth import Logout 
接 下 来 ， 修 改 Rango 应 用 的 urls.py 模块 ， 把 URL /rango/logout/ 映射 到 user_logout() 视图 上 : 


url(r'*logout/$', views.user_logout, name='logout'), 
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用 户 退 出 机 制 实 现 了 ， 最 后 再 完善 一 下 。 如 果 页 面 中 有 个 链接 ， 点 击 后 便 退 出 那 就 好 了 。 然 而 ， 
稍微 动 点 脑筋 便 会 想 出 一 个 问题 : 有 必要 向 未 登录 的 用 户 显 示 退 出 链接 吗 ? 可 能 没 必 要 ， 让 未 登 
录 的 用 户 方便 登录 或 许 更 好 。 


跟 之 前 一 样 ， 我 们 要 修改 Rango 应 用 的 base.himl 模板 ， 通 过 模板 上 下 文中 的 user 对 象 判 断 要 显 
示 哪 些 链接 。 在 文件 底部 找到 链接 列表 ， 替 换 为 下 述 代 码 。 注 意 ， 我 们 还 加 上 了 /rangolrestricted/ 


URL 上 受 限 制 的 页 面 。 


<UL> 


{% if user.is_authenticated %} 


<li><a href="{% 

<li><a href="{% 
{% else %} 

<li><a href="{% 

<li><a href="{% 
{% endif %} 

<li><a href="{% 

<li><a href="{% 

<li><a href="{% 
</ul> 


url 'restricted' %}">Restricted Page</a></li> 
url ‘logout! %}">Logout</a></li> 


url 'Login' %}">Login</a></li> 
url 'register' %}">Register Here</a></li> 


url 'add_category' %}">Add a New Category</a></li> 
url 'about' %}">About</a></li> 
url ‘index! %}">Index</a></li> 


这 有 段 代码 的 意思 是 ， 已 登录 的 用 户 能 看 到 “Restricted Page” Logout 链接 ， 未 登录 的 用 户 能 看 到 
“Register Here”* 和 “Login” 链 接 。“Add a New Category” 和 “About” 不 在 条 件 判 断 语句 块 中 ， 因 此 不 管 


用 户 是 否 登 录 都 能 看 到 。 


9.10 扩展 功能 


本 章 涵 盖 了 在 Django 应 用 中 验证 用 户 身份 的 多 个 重要 方面 。 我 们 介绍 了 如 何在 项 目 中 安装 Djan- 
go 提供 的 django.contrib.auth 应 用 ， 说 明了 如 何 为 django.contrib.auth.models.User 模型 增加 
字段 ， 还 讲解 了 实现 用 户 注 册 、 登 录 、 退 出 和 访问 限制 等 功能 的 详细 步骤 。 关 于 用 户 身份 验证 和 
注册 的 进一步 信息 ， 请 阅读 Django 文档 。 


很 多 Web 应 用 对 用 户 身份 要 求 的 更 严 。 例 如 ， 注 册 用 户 时 会 做 多 种 安全 检查 ， 确 保 提 供 的 电子 邮 


件 地 址 是 有 效 的 。 我 们 可 以 自己 实现 这 个 功能 ， 但 是 既然 有 现成 的 方案 ， 为 什么 要 重 造 轮子 呢 ? 
django-registration-redux 应 用 能 极 大 地 简化 为 用 户 身份 验证 添加 额外 功能 的 过 程 。 详 情 参 见 第 


11 章 。 
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cookie 和 会 话 


本 章 介绍 会 话 处 理 和 cookie 存储 的 基础 知识 。 会 话 和 cookie 是 互 不 可 分 的 两 个 概念 ， 对 如 今 的 
Web 应 用 极为 重要 。 前 一 章 涉 及 的 登录 和 退出 功能 就 是 基于 会 话 和 cookie 实现 的 。 然 而 ， 具 体 过 
程 被 Django 框架 隐藏 了 。 本 章 将 探讨 这 背后 到 底 发 生 了 什么 ， 以 及 cookie 还 能 用 来 做 什么 。 


10.1 cookie 无 处 不 在 


Web 服务 胡 收 到 请 求 后 会 返回 所 请 求 页 面 的 内 容 。 除 了 内 容 之 外 ， 还 会 返回 一 些 cookie, cookie 
可 以 理解 为 服务 右 发 给 客户 端的 少量 信息 。 准 备 发 送 请 求 时 ， 客 户 端 检查 有 没有 与 服务 器 地 址 匹 
配 的 cookie， 如 果 有 ， 随 请 求 一 起 发 送 。 服务 器 收 到 请 求 后 把 cookie 放 在 请 求 的 上 下 文中 解释 ， 
然后 生成 合适 的 啊 应 。 


以 使 用 用 户 名 和 密码 登录 网 站 为 例 。 通 过 身份 验证 后 ， 服 务 器 可 能 会 把 一 个 包含 用 户 名 的 cookie 
发 给 浏览 器 ， 指 明 那 个 用 户 已 经 登录 网 站 。 随 后 的 请 求 会 连同 这 个 信息 一 起 发 给 服务 器 ， 从 而 演 
染 针 对 已 登录 用 户 的 页 面 ， 例 如 在 页 面 的 某 个 位 置 显示 用 户 名 。 然 而， 会 话 不 是 永久 的 ， 因 为 
cookie 不 会 一 直 存在 ， 而 会 在 某 一 时 刻 过 期 。 涉 及 敏感 信息 的 Web 应 用 可 能 会 在 几 分 钟 之 后 就 让 
cookie 过 期 。 要 求 没 这 么 严格 的 Web 应 用 可 能 会 在 半 小 时 之 后 ， 甚 至 几 周 之 后 让 cookie 过 期 。 


* cookie 缘起 女 


cookie 这 个 词 不 是 取 自 食物 ，' MÆR A “magic cookie”( 收 到 后 不 经 修改 就 发 送 的 数据 

包 ) 。1994 年 ，MCI 向 Netscape Communications 提交 了 一 个 提案 ,描述 了 一 种 跨 HTTP 请 
求 的 持久 存储 方式 。 这 个 提案 源 自 他 们 开发 的 电子 商务 解决 方案 需要 一 种 可 靠 的 方式 存储 用 
户 购物 篮 中 的 内 容 。Netscape 的 程序 员 Lou Montulli 实现 了 这 个 提案 ， 将 其 命名 为 magic 


1. 英文 单词 cookie 有 “饼干” 意 。 译 者 注 
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cookie, 


关于 cookie 及 其 历史 的 更 多 信息 ， 请 阅读 纶 基 百 科 。 当 然 ， 这 个 伟大 提议 是 有 软件 专利 的 ， 
详情 参见 Montulli 在 美国 申请 的 5774670 号 专利 。 


以 cookie 的 形式 传递 信息 可 能 会 导致 Web 应 用 存在 安全 漏洞 ， 因 此 Web 应 用 的 开发 者 在 使 用 
cookie 时 一 定 要 谨慎 。 想 使 用 cookie 时 ,一 定 要 问 自己 : 真 的 有 必要 把 这 个 信息 存储 在 客户 端的 
cookie HI? 很 多 情况 下 ， 有 更 为 安全 的 方案 。 比 如 说 ， 电 商 网 站 通过 cookie 传送 用 户 的 信用 卡 
卡号 就 极 不 安全 。 nae, 如 果 用 户 的 电脑 被 攻击 了 呢 ? EP AT AB TERM cookie， 致 使 用 户 的 
信用 卡 卡号 泄露 一 一 这 全 是 因为 Web 应 用 的 设计 有 和 缺陷。 本 章 将 介绍 客户 端 cookie 和 服务 器 端 
会 话 存储 的 基础 知识 。 


欧盟 对 cookie 的 要 求 E 


2011 年 ， 欧 盟 发 布 了 一 部 关于 cookie 的 法 律 。 根 据 此 部 法 律 ， 存 贮 在 欧盟 境内 的 网 站 ， 在 
用 户 首次 访问 时 应 该 显示 一 个 关于 使 用 cookie 的 提醒 消息 。 图 10-1 是 BBC 新 闻 网 站 显示 的 
提醒 消息 。 


对 开发 网 站 的 你 来 说 ， 一 定 要 知道 这 部 法 律 ， 以 及 其 他 与 可 访问 性 有 关 的 法 律 。 


© © @ aa Home - BBC News x David 


e C [5 wwwbbce.co.uk/news wile o = 


Cookies on the 
BBC website 


| B] B] O News Sport Weather iPlayer TV Radio More ~ Search Q 


Find local news 9 


Home UK World Business Politics Tech Science Health Education Entertainment & Arts More ~ 


England N.Ireland Scotland Alba Wales Cymru 
ee a thi see ae Se 


图 10-1: BBC # AAs ( 存 贮 在 英国 ) 顶部 显示 的 cookie 提醒 消息 
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10.2 会 话 和 无 状态 协议 


Web 浏览 器 (客户 端 ) 与 服务 器 之 间 的 通信 都 借 由 HTTP 协议 。 前 面 说 过 ，HTTP 是 无 状态 的 协 
议 。 因 此 ，Web 浏览 器 所 在 的 客户 端 电脑 每 次 请 求 服务 器 中 的 资源 (HTTP GET) 或 者 把 资源 发 
给 服务 器 (HTTP POST) 都 要 建立 新 的 网 络 连接 (TCP 连接 ) 。? 


由 于 客户 端 和 服务 器 之 间 无 法 建立 持久 连接 ， 所 以 两 端的 软件 都 不 能 只 依靠 连接 维持 会 话 状态 。 
例如 ， 客 户 端 发 送 的 每 个 请 求 都 要 指明 哪个 用 户 在 当前 电脑 上 已 登录 Web 应 用 。 这 是 客户 端 与 服 
务 器 之 间 的 一 种 对 话 ， 是 半 永 久 性 信息 交互 机 制 ( 即 会 话 ) 的 基础 。 鉴 于 HTTP 是 无 状态 的 协 
议 ， 想 维持 会 话 状 态 还 是 有 一 定 难度 的 ， 不 过 我 们 无 需 担 心 ， 现 在 有 多 种 技术 能 解决 这 个 问题 。 


维持 状态 最 常用 的 一 种 方式 是 在 客户 端 电脑 的 cookie 中 存储 会 话 DD。 你 可 以 把 会 话 ID 理解 为 一 
种 令 牌 〈 一 串 字符 ， 或 一 个 字符 串 ) ， 我 们 通过 它 唯 一 标识 Web 应 用 中 的 会 话 。 这 种 方式 无 需 在 
客户 端的 cookie 中 存储 大 量 信息 (例如 用 户 名 、 姓 名 或 密码 ) ， 存 储 的 只 是 会 话 卫 。 通 过 这 个 
ID 可 以 从 Web 服务 器 中 获取 包含 所 需 信 息 的 数据 结构 。 通 过 这 种 方式 存储 用 户 的 信息 更 安全 ， 
不 会 由 于 客户 端的 漏洞 或 者 连接 被 监听 而 导致 信息 泄露 。 


现代 的 浏览 器 ， 只 要 不 特意 关闭 ， 都 支持 cookie。 你 访问 的 几乎 每 个 网 站 都 会 为 你 创建 一 个 会 
话 。 不 信 的 话 现在 你 就 可 以 确认 ， 如 图 10-2 所 示 。 以 Google Chrome 为 例 ， 通 过 开发 者 工具 便 可 
以 查看 当前 访问 网 站 的 cookie。 依 次 点 击 菜单 “Chrome 设置 > 更 多 工具 > 开发 者 工具 ”， 在 打开 的 
开发 者 工具 面板 中 点 击 “Application”* 标 签 页 ， 在 左 侧 的 “Storage” 菜 单 中 找到 “Cookies”"。 如 果 你 打 
开 的 是 Rango 应 用 的 某 个 页 面 ， 应 该 会 看 到 一 个 名 为 sessionid 的 cookie。 这 个 cookie 的 值 是 一 
系列 字母 和 数字 ，Django 就 是 通过 这 个 值 唯一 标识 你 电脑 中 的 这 个 会 话 的 。 通 过 会 话 ID 可 以 获 
取 所 有 会 话 信息 ， 只 不 过 这 些 信息 存 储 在 服务 右 端 。 


* 不 使 用 cookie 的 方式 x 


持久 存储 状态 信息 的 另 一 种 方式 是 在 URL 中 编码 会 话 一。 例如 ， 你 可 能 见 过 这 样 的 PHP 网 


页 地 址 : Attp://www.site.com/index php? sessid=someseeminglyrandomandlongstring 1234 , XP} 
方式 不 在 客户 端 设 备 中 存储 cookie， 但 是 URL 不 太 好 看 。 这 与 Django 推崇 的 人 类 可 读 的 简 
洁 URL 相悖。 


2. HTTP 1.1 其 实 支持 在 一 个 TCP 网 络 连接 中 发 送 多 个 请 求 。 这 样 能 极 大 地 提升 性 能 ， 尤 其 是 在 延迟 高 的 网 络 连 接 中 
(例如 传统 的 拨号 上 网 或 卫星 上 网 ) 。 这 种 技术 称 为 HTTP 管线 化 ， 详 情 参 见 维基 百科 。 
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图 10-2: 在 Google Chrome 的 开发 者 工具 中 查看 sessionid cookie 


10.3 在 Django 中 设置 会 话 


虽然 你 需要 的 功能 可 能 已 经 设置 好 ， 拿 来 就 能 用 ， 但 最 好 知道 Django 的 某 个 模块 提供 的 是 什么 功 
能 。 本 章 所 讲 的 会 话 ， 在 Django 中 通过 中 间 件 实现 。 


为 了 确保 万 无 一 失 ， 请 打开 Django 项 目的 settings.py 文件 ， 找 到 MIDDLEWARE 列表 。 这 个 列表 中 应 
该 有 个 元 素 是 django.contrib.sessions.middleware.SessionMiddleware。 如 果 没 有 ， 请 自己 动手 


加 上 。sessionid cookie 就 是 由 SessionMiddleware 中 间 件 创建 的 。 


SessionMiddleware 中 间 件 文 持 多 种 存储 会 话 信 息 的 方式 ， 可 以 存在 文件 中 、 数 据 库 中 ， 甚 至 是 内 

存 中 。 最 简单 的 方法 是 使 用 django.contrib.sessions 应 用 ， 把 会 话 信息 存储 在 模型 /数据 库 中 
(模型 为 django.contrib.sessions.models.Session) 。 若 想 使 用 这 种 方法 ，Django 项 目的 
INSTALLED_APPS 设置 中 还 要 列 出 django.contrib.sesstions。 别 忘 了 ， 添 加 这 个 应 用 后 还 要 使 用 迁 


移 命令 更 新 数据 库 。 


太 把 会 话 存 入 缓存 太 


如 果 想 提升 性 能 ， 可 以 考虑 使 用 某 种 缓存 机 制 存储 会 话 信 息 。 详 情 参见 Django 文档 。 
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10.4 测试 是 否 支 持 cookie 


虽然 所 有 现代 的 Web 浏览 器 都 支持 cookie， 但 是 在 某 些 安全 级 别 下 可 能 会 被 禁用 。 因 此 ， 在 使 用 
cookie 之 前 要 测试 一 下 。 不 过 ， 这 一 步 基 本 上 是 多 余 的 。 


测试 是 否 支 持 cookie 时 ， 可 以 使 用 Django 的 request 对 象 提供 的 三 个 便利 方法 : 
set_test_cookie(), test_cookie_worked() 和 delete_test_cookie()。 我 们 要 在 一 个 视图 中 设 定 
测试 cookie， 然 后 在 另 一 个 视图 中 检查 那个 cookie 是 否 存 在 。 注 意 ， 必 须 使 用 两 个 不 同 的 视图 ， 
因为 我 们 要 等 到 下 一 次 请 求 才 能 确认 客户 端 是 否 接 受 服务 器 发 送 的 Cookie, 


这 里 ， 我 们 将 使 用 两 个 现 有 的 锐 图 做 个 简 辕 的 测试 ; index() 和 about()。 但 是 我 们 不 在 页 面 中 显 
示 什 么 内 容 ， 而 是 通过 Django 开发 服务 右 在 终端 里 的 输出 判断 是 否 支 持 cookie, 


打开 Rango 应 用 的 views.py 文件 ， 找 到 index() 视图 。 在 视图 中 添加 下 述 代 码 。 为 了 确保 这 一 行 
一 定 会 被 执行 ， 请 将 其 放 在 视图 的 第 一 行 


request.session.set_test_cookie() 


然后 找到 about() 视图 ， 把 下 面 三 行 添加 到 函数 前 音 


if request.session.test cookie worked(): 
print("TEST COOKIE WORKED!") 
request.session.delete_test_cookie() 


最 后 ， 启 动 Django 开发 服务 器 ， 在 浏览 器 中 访问 Rango 应 用 的 首页 ， 接 着 再 访问 关于 页 面 。 在 
Django 开发 服务 器 的 控制 台中 应 该 会 看 到 “TEST COOKIE WORKED!”, 4E 10-3 所 示 。 


@e0oe tango_with_django_project — 89x17 


图 10-3: Django 开发 服务 器 的 控制 台中 显示 有 “TEST COOKIE WORKED!” i¥f $ 
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如 果 没 显示 上 述 消 息 ， 请 检查 浏览 器 的 安全 设置 。 某 些 设置 可 能 会 导致 浏览 器 不 接受 cookie, 


10.5 客户 端 cookie， 访 问 次 数 统计 示例 


知道 cookie 的 工作 原理 之 后 ， 下 面 来 实现 一 个 非常 简单 的 网 站 访问 次 数 统计 功能 。 为 此 ， 我 们 要 
创建 两 个 cookie: 一 个 记录 用 户 访问 Rango 应 用 的 次 数 ， 另 一 个 记录 用 户 最 后 一 次 访问 网 站 的 时 
间 。 之 所 以 记录 最 后 访问 时 间 ， 是 因为 我 们 只 想 一 天 增加 一 次 访问 次 数 ， 以 防 有 人 恶意 刷 次 数 。 


假设 有 用 户 访问 Rango 应 用 的 合理 位 置 是 首页 。 我 们 要 定义 一 个 函数 ， 传 人 request 和 response 
对 象 ， 让 它 处 理 cookie。 然 后 在 Rango 应 用 的 index() 视图 中 调用 。 打 开 Rango 应 用 的 views py 
文件 ， 添 加 下 述 函 数 。 注 意 ， 严 格 来 说 这 不 是 视图 函数 ， 而 是 个 辅助 浮 数 ， 因 为 它 不 返回 
response 对 象 。 


def visitor_cookie_handler(request, response): 
# 获取 网 站 的 访问 次 数 
# 使 用 COOKIES.get() 函数 读 取 “visits”cookie 
# 如 果 目 标 cookie 存在 ， 把 值 转换 为 整数 
# 如 果 目 标 cookie 不 存在 ， 返 回 默认 值 1 
visits = int(request.COOKIES.get('visits', '1')) 


last visit cookie = request.COOKIES.get('last_visit', str(datetime.now())) 
last visit time = datetime.strptime(Last_visit_cookie[:-7], 
'%Y-%m-%d %H:%M:%S') 


H 如 果 距 上 次 访问 已 超过 一 天 ..… 
if (datetime.now() - last visit time).days > 0: 
visits = visits + 1 
# 增加 访问 次 数 后 更 新 “last_visit”cookie 
response.set_cookie('last_visit', str(datetime.now())) 
else: 
# 72 “last_visit”’ cookie 


response.set_cookie('lLast_visit', last visit cookie) 


# 更 新 或 设 定 “visits”cookie 


response.set_cookie('visits', visits) 
这 个 辅助 函数 的 参数 有 两 个 ， 分 别 为 request 和 response 对 象 ， 因 为 我 们 既 需 要 从 人 站 请 求 中 读 


取 cookie， 也 需要 把 cookie 添加 到 啊 应 中 。 在 这 个 函数 中 ， 我们 调用 了 request.COOKIES .get() 
函数 ， 这 也 是 一 个 辅助 函数 ， 由 Django 提供 。 如 果 指 定 的 cookie 存在 ，COOKIES.get() 函数 返回 
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cookie 的 值 ， 如 果 不 存 在 ， 我 们 可 以 提供 一 个 默认 值 。 


得 到 两 个 cookie 的 值 之 后 ， 计 算 两 次 访问 的 间隔 有 没有 超过 一 天 。 如 果 无 需 相隔 一 天 ， 可 以 把 
.days 改 成 .seconds， 这 样 只 要 相差 一 秒 就 能 更 新 访问 次 数 。 


注意 ， 所 有 cookie 的 值 都 是 字符 串 。 不 要 以 为 存储 整数 的 cookie 会 返回 整数 类 型 的 值 。 你 要 自行 


转换 为 


E 确 的 类 型 ， 因 为 cookie 六 


F 不 知道 它 存储 的 值 是 什么 类 型 。 


如 果 cookie 不 存在 ， 可 以 在 response 对 象 上 调用 set_cookie() 方法 ， 创 建 一 个 cookie。 这 个 方 
法 接受 两 个 参数 ， 一 个 是 想 创 建 的 cookie 名 称 (字符 串 形式 ) ， 男 一 个 是 cookie 的 值 。 传 人 的 
cookie 值 不 限 类 型 ，set_cookie() 方法 会 自动 将 其 转换 为 字符 串 。 


这 个 函数 用 到 了 datetime 模块 ， 因 此 要 在 views py 文件 的 顶部 将 其 导入 。 


from datetime import datetime 


然后 更 新 index() 视图 ， 调 用 visitor_cookie_handler() 辅助 函数 。 为 此 ， 要 先 提 取得 到 
response 对 象 。 


def 


index(request): 

category_List = Categor 
page_list = Page.object 
context_dict = {'catego 


y.objects.order_by('-likes')[:5] 
s.order_by('-views')[:5] 
ries': category_list, 'pages': page_ list} 


# 提前 获取 response XR, VIA cookie 


response = render(reque 


st, 'rango/index.html', context_dict) 


# 调用 处 理 cookie 的 辅助 函数 


visitor_cookie_handler( 


request, response) 


# 返回 response 对 象 ， 更 新 目标 cookie 


return response 


现在 ,访问 Rango 应 用 的 首页 ， 然 后 打开 浏览 器 中 的 cookie 查看 工具 (例如 Google Chrome 的 开 


发 者 工具 


) ， 你 应 该 能 看 到 visits 和 Last_visit 两 个 cookie， 如 图 10-4 所 示 。 此 外 ， 还 可 以 更 


新 index.html 模板 ， 添 加 <p>visits: {{ visits }}</p>， 显 示 访 问 次 数 。 
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图 10-4: 在 Google Chrome 中 打开 开发 者 工具 查看 Rango 应 用 的 cookie; 留意 visits cookie, 其 
值 表 明 一 共 访 问 了 三 次 ， 而 且 每 次 至 少 相 隔 一 天 


10.6 会 话 数据 


前 一 节 的 示例 展示 了 如 何 存储 和 处 理 客户 端 cookie， 此 时 数据 存储 在 客户 端 。 然 而 ， 为 了 会 话 信 
县 的 安全 ， 最 好 将 其 存储 在 服务 器 端 ， 然 后 通过 存储 在 客户 端的 会 话 ID 访问 会 话 数据 。 


使 用 基于 会 话 的 cookie 的 基本 步 又 如 下 : 


@ 确保 settings py 模块 中 的 MIDDLEWARE_CLASSES 列表 里 有 
django.contrib.sessions.middleware. SessionMiddLleware, 


@ 配置 会 话 后 端 。 确 保 settings py 模块 中 的 INSTALLED_APPS 列表 里 有 
django.contrib.sessions。 如 果 没 有 ， 加 上 ， 然 后 运行 数据 库 迁 移 命令 python manage.py 


migrate, 
© 默认 使 用 的 是 数据 库 后 端 ， 不 过 也 可 以 设置 为 其 他 后 端 (例如 缓存 ) 。 详 情 参见 Django X 
档 。 


基于 会 话 的 cookie 不 直接 存储 在 请 求 中 〈 因 此 也 不 保存 在 客户 端 设 备 中 ) ， 读 取 使 用 
request.session.get() 方法 ， 存 储 新 值 使 用 request.session[]。 注 意 ， 为 了 记 住 客户 端 设备 ， 
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依然 要 在 客户 端 cookie 中 存储 会 话 一 。 然 而 ， 用 户 /会 话 数据 全 部 保存 在 服务 器 端 
会 话 中 间 件 能 处 理 这 两 端的 操作 。 


的 


为 了 使 用 服务 器 端 存 储 的 数据 ， 我 们 要 重 构 前 一 节 编 写 的 代码 。 首 和 完 ， 更 新 


visitor_cookie_handler() 函数 ， 改 为 从 服务 器 端 存 取 cookie: 
读 取 cookie， 通 过 request.session[] 更 新 cookie。 简 便 起 见 ， 我 们 定义 一 个 辅助 函数 ， 名 为 
get_server_side_cookie()， 让 它 从 请 求 中 读 取 cookie， 如 果 会 话 数 据 中 有 指定 


fE, 


否则 返回 默认 值 。 


o Django 提供 


调用 request.session.get() 方法 


的 cookie， 返 回 其 


既然 现在 所 有 cookie 都 存储 在 服务 器 端 ， 我 们 就 不 用 直接 修改 响应 了 。 鉴 于 此 ， 
visitor_cookie_handler() KXU Fy response 可 以 删 掉 了 。 


# 辅助 函数 
def get_server_side_cookie(request, cookie, default_val=None): 
val = request.session.get(cookie) 
if not val: 
val = default_val 
return val 


# 更 新 后 的 函数 定义 
def visitor_cookie_handler(request): 
visits = int(get_server_side_cookie(request, 'visits', '1')) 
last visit cookie = get_server_side_cookie(request, 
"lLast_visit', 
str(datetime.now())) 
last visit time = datetime.strptime(Last_visit_cookie[:-7], 
'%Y-%m-%d %H:%M:%S') 


H 如 果 距 上 次 访问 已 超过 一 天 .… 
if (datetime.now() - last visit time).days > 0: 
visits = visits + 1 
# 增加 访问 次 数 后 更 新 “last_visit”cookie 
request.session['last_visit'] = str(datetime.now()) 
else: 
# g “last_visit”cookie 
request.session['Last_visit'] = last_visit_cookie 


# 2H AML “visits” cookie 


request.session[ 'visits'] = visits 
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更 新 完 处 理 cookie 的 辅助 函数 之 后 ， 接 下 来 要 更 新 index() 视图 。 首 先 ， 把 


visitor_cookie_handler(request, response) 改 成 visitor_cookie_handler(request)。 然 后 ， 添 


加 下 面 这 行 ， 把 访问 次 数 传 人 上 下 文字 典 。 
context_dict['visits'] = request.session['visits'] 
这 一 行 要 在 调用 render() 函数 之 前 执行 ， 否 则 无 效 。 修 改 后 的 index() 视图 如 下 所 示 。 


def index(request): 
request.session.set_test_cookie() 
category_list = Category.objects.order_by('-likes')[:5] 
page_list = Page.objects.order_by('-views')[:5] 
context_dict = {'categories': category_list, 'pages': page list} 


visitor_cookie_handler(request) 
context_dict['visits'] = request.session['visits' ] 


response = render(request, 'rango/index.html', context=context_dict) 
return response 


在 重启 Django 开发 服务 器 之 前 先 把 客户 端 现 有 的 cookie 删除 。 详 情 参 见 下 面 的 提醒 。 


+ 避免 cookie RA @ 


转 用 基于 会 话 的 cookie 之 前 强烈 建议 先 把 客户 端 cookie 删除 。 可 以 在 浏览 器 的 cookie 查看 


工具 中 一 个 一 个 删除 ， 也 可 以 直接 清除 浏览 器 的 缓存 (确保 选中 删除 cookie 的 选项 ) 。 


* cookie 的 数据 类 型 文 


把 会 话 数 据 存储 在 服务 器 端的 额外 好 处 是 ， 可 以 把 字符 串 数 据 转 换 成 所 需 的 类 型 。 不 过 这 只 


对 内 置 类 型 有 效 ， 例 如 int, float, long, complex 和 bootean。 如 果 想 存储 字典 或 其 他 复杂 
的 类 型 ， 可 以 考虑 序列 化 对 象 。 


10.7 浏览 器 存续 期 会 话 和 持久 会 话 


Django 的 会 话 框 架设 定 的 会 话 分 为 浏览 器 存续 期 会 话 和 持久 会 话 两 种 。 
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J 浏览 器 存续 期 会 话 在 用 户 关 闭 浏览 器 后 过 期 
J 持久 会 话 不 在 浏览 器 关闭 后 过 期 ， 而 是 由 你 自己 指定 过 期 时 间 ， 可 以 是 半 个 小 时 ， 其 至 几 
个 月 


默认 情况 下 ， 浏 览 器 存续 期 会 话 是 禁用 的 。 若 想 启 用 ， 打 开 Django 项 目的 settings py 模块 ， 添 加 
SESSION_EXPIRE_AT_BROWSER_CLOSE 变量 ， 把 值 设 为 True。 


默认 启用 的 是 持久 会 话 ， 此 时 SESSION_EXPIRE_AT_BRONSER_CLOSE 的 值 为 FaLse， 或 者 不 存在 。 持 
久 会 话 还 有 个 设置 ，SESSION_COOKIE_AGE， 用 于 设 定 cookie 的 存活 期 。 这 个 设置 的 值 是 一 个 整 
数 ， 表 示 cookie 存活 的 秒 数 。 例 如 ， 如 果 把 值 设 为 1209666， 网 站 的 cookie 将 在 两 周 (14 R) 后 
过 期 。 


可 用 选项 的 详细 说 明 参 阅 Django 文档 。Eli Bendersky 写 的 这 篇 博客 文章 也 值得 一 读 。 


10.8 清理 会 话 数据 库 
会 话 不 断 增 多 ， 存 储 会 话 信息 的 数据 存储 器 随 之 不 断 增 大 。 如 果 使 用 数据 库存 储 Django 会 话 ， 要 


定期 清理 数据 库 。 使 用 的 命令 是 python manage.py clearsessions, Django 文档 建议 通过 cron 作 
业 每 天 运行 一 次 这 个 命令 。 如 若 不 然 ， 随 着 用 户 数量 的 增多 ， 你 会 发 现 应 用 的 性 能 每 况 愈 下 。 


10.9 注意 事项 和 基本 流程 


在 Django 应 用 中 使 用 cookie 时 要 注意 以 下 几 点 : 


J 首先 ， 确 定 你 的 Web 应 用 需要 哪 种 cookie。 你 想 存 储 的 信息 需要 在 浏览 器 关闭 后 留存 吗 ， 
能 在 会 话 结束 后 弃 之 不 用 吗 ? 

J 审慎 决定 要 在 cookie 中 存储 哪些 信息 。 记 住 ，cookie 中 的 信息 保存 在 客户 端 电 脑 中 ， 这 隐 
藏 着 巨大 的 安全 隐患 ， 毕 竟 你 对 用 户 电 脑 的 安全 保护 措施 一 无 所 知 。 涉 及 敏感 信息 时 ， 应 
该 考虑 使 用 服务 器 端 会 话 。 

口 用 户 可 能 会 把 浏览 器 的 安全 设置 设 为 较 高 的 级 别 ， 禁 止 使 用 cookie， 从 而 导致 网 站 的 功能 

失效 。 一 定 要 考虑 这 种 情况 ， 因 为 你 对 用 户 的 浏览 器 设置 没有 控制 权 。 


如 有 果 决 定 使 用 客户 端 cookie， 遵 照 下 述 步骤 操作 : 


@ 必须 先 检查 想 使 用 的 cookie 是 否 存 在 。request.COOKIES.has_key('<cookie_name>') pK AR 
回 一 个 布尔 值 ， 指 明 名 为 <cookie_name> 的 cookie 是 否 存 在 于 客户 端 电 脑 中 。 
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© 如 果 目 标 cookie 存在 ， 便 可 以 读 取 其 值 ， request.C00OKIES[]。COOoKIES 属性 的 值 是 个 字 
典 ， 因 此 想 读 取 cookie 时 ， 把 cookie 的 名 称 (ARIS) 传人 方 括号 中 。 记 住 ，cookie 
的 值 始终 为 字符 串 ， 不 管 存储 的 值 是 什么 语义 。 因 此 ， 要 做 好 转换 类 型 的 准备 〈 例 如 使 用 
int() 或 fLoat()) 。 


© 如 果 目 标 cookie 不 存在 ， 或 者 想 更 新 cookie， 把 想 保 存 的 值 传 给 生成 的 响应 。 要 调用 的 函 
数 是 response.set_cookie('<cookie_name>' ，value)， 第 一 个 参数 是 cookie 的 名 称 ， 第 二 
个 参数 是 要 设 定 的 值 。 


= 


如 果 对 安全 要 求 更 高 ， 应 该 使 用 基于 会 话 的 cookie。 


@ 首先 ， 确 保 Django 项 目的 settings py 模块 中 的 MIDDLEWARE_CLASSES 列表 里 有 
django.contrib.sessions.middleware.SessionMiddleware。 如 果 没 有 ， 自 行 加 上 。 


@ 使 用 SESSION_ENGINE 配置 会 话 后 端 。 不 同 的 后 端 配 置 参 见 Django 文档 。 
© 通过 requests.sessions.get() 检查 cookie 是 否 存 在 。 


O 通过 会 话 字 典 更 新 或 设 定 cookie: requests.session[ '<cookie_name>'], 


</> 练习 


请 完成 以 下 练习 ， 巩 固 本 昔 所 学 的 知识 


J 确认 你 的 cookie 存储 在 服务 器 端 。 清 空 浏览 器 的 缓存 和 cookie， 然 后 确认 浏览 器 中 没 
有 last_visit 和 visits 两 个 cookie。 注 意 ，sessionid cookie 应 该 还 有 。Django 通过 


这 个 cookie 从 数据 库 中 检索 存储 在 服务 器 端的 会 话 数 据 。 

J 更 新 关于 页 面 的 视图 和 模板 ， 告 诉 访客 他 们 访问 了 多 少 次 网 站 。 记 得 先 调用 
visitor_cookie_handler() 国 数 ， 再 从 request.session 字典 中 读 取 visits cookie。 如 
BAI, visits cookie 不 存在 的 话 ， 程 序 会 抛 出 错误 。 
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使 用 Django-Registration-Redux 


在 第 9 章 ， 我 们 自己 动手 创建 视图 、 模 板 和 URL 上 映射， 为 Rango 应 用 添加 了 登录 和 注册 功能 。 
然而 ， 这 些 功 能 在 Web 应 用 中 太 和 常见 了 ， 因 此 别 的 开发 者 已 经 创建 了 众多 拿 来 即 用 的 扩展 应 用 ， 
能 为 Django 项 目 提供 登录 、 注 册 、 一 步 和 两 步 身 份 验证 、 密 码 修改 、 密 码 重 设 等 功能 。 本 章 将 使 
用 django-registration-redux 包 实 现 这 些 功 能 。 


为 此 ， 我 们 要 重 构 代 码 ， 删 掉 前 面 实现 的 登录 和 注册 功能 ， 然 后 配置 项 目 ， 使 用 
django-registration-redux 应 用 。 读 完 本 章 后 ， 你 将 掌握 使 用 外 部 应 用 的 方法 ， 一 锻 整 个 过 程 是 


多 么 简单 。 


11.1 安装 和 设置 


首先 ， 使 用 pip 在 你 的 虚拟 环境 中 安装 django-registration-redux 1.4 版 : 


$ pip install -U django-registration-redux==1.4 


然后 告诉 Django， 我 们 想 使 用 这 个 应 用 。 打 开 settings py 文件 ， 更 新 INSTALLED_APPS 列表 : 


INSTALLED_APPS = [ 
"django.contrib. 
"django.contrib. 
‘django.contrib. 
"django.contrib. 
"django.contrib. 
"django.contrib. 
"rango', 
‘registration’ 


] 


admin', 

auth', 
contenttypes', 
sessions', 
messages', 
staticfiles', 


@ 


# 增加 registration 


既然 打开 settings py 文件 了 ， 顺 便 添 加 这 个 包 所 需 的 几 个 配置 变量 : 


# A True, AFA PEM 
REGISTRATION_OPEN = True 


# 留 一 周 的 激活 时 间 ; 当然 ， 也 可 以 设 为 其 他 值 
ACCOUNT_ACTIVATION_DAYS = 7 

# 设 为 True， 注 册 后 自动 登录 
REGISTRATION_AUTO_LOGIN = True 


# 登录 后 呈现 给 用 户 的 页 面 


LOGIN_REDIRECT_URL = '/rango/' 
# 未 登录 以 及 访问 需要 验证 身份 的 页 面 时 重 定向 的 页 面 
LOGIN_URL = '/accounts/login/' 


接 下 来 ， 打 开 tango_with_django_project/urls py 文件 ， 更 新 urlpatterns, ¥|A registration 包 的 


URL 映射 : 


url(r'4accounts/', include('registration.backends.simple.urls')), 


django-registration-redux 包 提 供 了 不 同 的 注册 后 端 ， 能 满足 不 同 的 需求 。 例 如 ， 你 可 能 想 使 用 


两 步 验 证 ， 向 用 户 发 送 一 封 确认 由 


% 件 ， 里 面 有 个 确认 链接 。 这 里 ， 我 们 使 用 的 是 简单 的 一 步 注册 


过 程 ， 和 输入 用 户 名 、 电 子 邮 件 地 址 和 密码 即 可 注册 ， 而 且 成 功 注册 后 自动 登录 。 


11.2 各 项 操作 的 UR 


L 映射 


django-registration-redux 包 提 供 了 多 种 操作 。registration.backend.simple.urls 中 包含 下 述 


映射 : 


注册 一 /accounts/register/ 


登录 一 /accounts/login/ 


退出 一 /accounts/logout/ 


U U OU U U U 


注册 完成 一 /accounts/register/complete/ 


修改 密码 一 /password/change/ 


重 设 密码 一 /password!reset/ 


registration.backends.default.urls 还 提供 了 两 步 注 册 过 程 中 激活 账户 这 一 步 : 


“1 激活 一 activate/<activation_key>/ 
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Redux 


D 成功 激活 一 activate/complete/ 
J 激活 电子 邮件 


”激活 邮件 的 正文 (一 个 文本 文件 ) 
”激活 邮件 的 主题 (一 个 文本 文件 ) 


下 面 是 关键 所 在 。 虽 然 django-registration-redux 包 提 供 了 上 述 丰 富 的 功能 ， 但 是 没有 提供 模 
板 ， 因 为 每 个 应 用 都 有 自己 的 结构 和 外 观 设计 。 所 以 ， 接 下 来 我 们 要 创建 各 视图 的 模板 。 


11.3 创建 模板 


django-registration-redux 包 的 快速 入 门 指南 简要 说 明了 需要 哪些 模板 ， 但 是 没有 明确 指明 各 模 
板 的 内 容 。 你 可 以 自行 试验 ， 写 出 所 需 的 代码 。 不 过 我 们 可 以 走 个 捷径 ， 参 考 Anders Hofstee 4 
写 的 模板 。 


首先 ， 在 templates 目录 中 新 建 一 个 目录 ， 命 名 为 registration。django-registration-redux 应 用 相 
关 的 模板 都 保存 在 这 个 目录 中 。 


登录 页 面 的 模板 
在 templates/registration 目录 中 新 建 login.html 文件 ， 写 人 下 述 代码 : 


{% extends "rango/base.html" %} 
{% block body_block %} 
<h1i>Login</h1> 
<form method="post" action="."> 
{% csrf_token %} 
{{ form.as_p }} 
<input type="submit" value="Log in" /> 
<input type="hidden" name="next" value="{{ next }}" /> 
</form> 
<p> 
Not a member? 
<a href="{% url 'registration_register' %}">Register</a> 
</p> 
{% endblock %} 


注意 ， 所 有 URL 都 使 用 url 模板 标签 引用 。 如 果 记 不 得 ， 可 以 访问 hetp-//127.0.0.1 :8000/ac- 
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counts/， 这 个 页 面 列 出 了 全 部 URL 映射 ， 以 及 各 URL 对 应 的 名 称 (假设 settings py 中 设 定 了 
DEBUG=True) 。 


注册 页 面 的 模板 


在 templates/registration 目录 中 新 建 registration_form.html 文件 ， 写 人 下 述 代 码 : 


{% extends "rango/base.html" %} 
{% block body_block %} 
<hi>Register Here</h1> 
<form method="post" action="."> 
{% csrf_token %} 
{{ form.as_p }} 
<input type="submit" value="Submit" /> 
</form> 
{% endblock %} 


注册 完成 页 面 的 模板 
在 templates/registration 目录 中 新建 registration_complete.html 文件 ， 写 入 下 述 代码 : 


{% extends "rango/base.html" %} 

{% block body_block %} 
<hi>Registration Complete</h1> 
<p>You are now registered</p> 

{% endblock %} 


退出 页 面 的 模板 


在 templates/registration 目录 中 新 建 logout.html 文件 ， 写 人 下 述 代码 : 


{% extends "rango/base.html" %} 
{% block body _block %} 

<hi>Logged Out</h1> 

<p>You are now Logged out.</p> 
{% endblock %} 
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iat — TEHE 


启动 Django 开发 服务 器 ， 访 问 http://127.0.0.1:8000/accounts/register/, YER, FERRE PAWS 
密码 字段 ， 用 于 确认 密码 。 自 己 注册 试 试 ， 两 次 输入 不 同 的 密码 。 


这 只 是 整个 过 程 的 其 中 一 步 。 


重 构 项 目 
接 下 来 更 新 base.html 模板 ， 使 用 新 的 URL 和 视图 。 


a 把 注册 链接 改 为 <a href="{% url 'registration_register' %}">, 


a 把 登录 链接 改 为 <a href="{% url ‘auth_login' %}">, 


口 把 退出 链接 改 为 <a href="{% url 'auth_Logout' %}?next=/rango/">, 


J Æ settings.py 文件 中 ， 把 LOGIN_URL 改 为 '/accounts/login/'。 


注意 ， 退 出 URL 的 后 面 有 ?next=/rango/， 这 样 退 出 后 才 会 重 定向 到 Rango 应 用 的 首页 。 否 则 ， 
退出 后 将 重 定 向 到 退出 页 面 ， 这 样 不 太 友 好 。 


接 下 来 要 停 用 Rango 应 用 中 的 注册 、 登 录 和 退出 功能 : 把 相关 的 URL 映射 、 视 图 和 模板 删除 
(或 者 注释 掉 ) 。 


F 


修改 注册 流程 


现在 ， 用 户 成 功 注册 后 会 转 到 注册 完成 页 面 。 这 样 感觉 有 点 多 此 一 举 。 因 此 ， 我 们 修改 一 下 ， 转 
向 首页 。 为 此 要 履 盖 registration.backends.simple.views 提供 的 RegistrationView。 打 开 tan- 
go_with_django_project/urls py 文件 ， 导 人 RegistrationView， 然 后 定义 一 个 RegistrationView 的 
FH, 


from registration.backends.simple.views import RegistrationView 


# 定义 一 个 类 
# 用 户 成 功 注册 后 重 定 向 到 首页 
class MyRegistrationView(RegistrationView) : 
def get_success_url(self, user): 
return '/rango/' 


然后 修改 Django 项 目的 urls py 模块 中 的 urlpatterns 列表 ， 在 accounts 模式 前 添加 下 述 代 码 ， 
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以 便 在 其 他 accounts/ URL 之 前 匹配 accounts/register。 注 意 ， 修 改 的 不 是 rango 目录 中 的 urls.py 
模块 。 


url(r'^accounts/register/$', 
MyRegistrationView.as_view(), 
name='registration_register'), 


这 样 修改 之 后 ， 成 功 注册 后 便 会 重 定向 到 我 们 指定 的 页 面 。 
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集成 Bootstrap 


本 章 使 用 Twitter Bootstrap ! 装饰 Rango YA, Bootstrap 是 最 为 流行 的 HTML、CSS 和 JavaScript 
框架 ， 支持 啊 应 式 设计 ， 简 单 易 用 。 


* 层 径 样式 表 文 


WER RARE CSS， 推 荐 阅读 《CSS 实 成 手册 》 一 书 ， 学 习 层 三 样式 表 的 基础 知识 。 


现在 打开 Bootstrap 的 网 站 ， 可 以 看 到 网 站 给 出 了 很 多 示例 代码 ， 说 明了 各 组 件 的 用 法 。 此 外 ， 
Bootstrap 的 网 站 中 还 有 一 些 布局 示例 ， 我 们 可 以 参照 这 些 示例 设计 Rango 应 用 。 


在 众多 布局 中 ， 笔 者 觉得 这 个 管理 后 台 比 较 适 合 Rango， 有 导航 栏 、 侧 边栏 (用 于 显示 分 类 列 
K) 和 主 内 容 区 。 


打开 这 个 管理 后 台布 局 ， 保 存 HTML 源码， 存储 在 templates/rango 目录 里 ， 命 名 为 base_boot- 


strap html , 
为 了 在 Rango 应 用 中 使 用 ， 还 要 做 些 修改 ; 


口 把 所 有 ../../ 路 径 蔡 换 为 http://v4-aLpha.getbootstrap.com/ 。 


L 把 dashboard.css 的 路 径 蔡 换 为 绝对 地 址 : http://v4-alpha.getbootstrap.com/examples/ 
dashboard/dashboard.css。 


O 把 导航 栏 中 的 搜索 框 删除 。 


1. 翻译 时 Bootstrap 4 已 经 正式 发 布 。 原 书 使 用 的 还 是 Bootstrap 4 Alpha 版 ， 因 此 Bootstrap 相关 的 链接 仍然 指向 v4 
Alpha 版 。 一 一 译 者 注 
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J 把 页 面 中 不 相关 的 内 容 都 删 掉 ， 蔡 换 为 { block body_block %}{% endblock %}, 


J 把 页 面 的 标题 元 素 改 为 <title> Rango - {% block title %}How to Tango with Django! {% 
endblock %} </title>, 


把 网 站 名 称 (“Dashboard”) 改 为 “Rango”。 
在 导航 栏 中 添加 首页 、 登 录 和 注册 等 页 面 的 链接 。 
添加 侧 边 栏 区 块 . {% block sidebar_block %}{% endblock %}。 


m) 
m) 
E 
m) 


12.1 模板 


@ 不 要 复制 粘贴 多 


在 DOCTYPE 下 面 添加 {% load staticfiles %}。 


笔者 早 就 提醒 过 ， 不 要 直接 复制 粘贴 书 中 的 代码 。 请 自己 输入 ， 在 输入 的 过 程 中 想 一 想 下 述 
HTML 标记 的 作用 。 如 果 你 不 知道 某 个 标签 的 作用 ， 请 在 网 上 搜索 。 如 果 你 不 知道 某 个 
Bootstrap CSS 类 的 作用 ， 请 查阅 文档 。 


<!DOCTYPE html> 
{% load staticfiles %} 
{% load rango_template_tags %} 
<html lang="en"> 
<head> 
<meta charset="utf-8"> 
<meta http-equiv="X-UA-Compatible" content="IE=edge"> 
<meta name="viewport" content="width=device-width, 
initial-scale=1, shrink-to-fit=no"> 


<meta name="description" content=""> 
<meta name="author" content=""> 
<link rel="icon" href="{% static 'images/favicon.ico' %}"> 
<title> 
Rango - {% block title %}How to Tango with Django!{% endblock %} 
</title> 
<!-- Bootstrap core CSS --> 
<link href="http://v4-alpha.getbootstrap.com/dist/css/bootstrap.min.css" 
rel="stylesheet"> 
<!-- Custom styles for this template --> 
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<link href= 


"http: //v4-alpha.getbootstrap.com/examples/dashboard/dashboard.css" 


rel="stylesheet"> 
</head> 
<body> 


<nav class="navbar navbar-toggleable-md navbar-inverse fixed-top bg-inverse'"> 


<button class="navbar-toggler navbar-toggler-right hidden-1lg-up” 
type="button" 
data-toggle="collapse" 
data-target="#navbar" 
arta-controls="navbar" 
aria-expanded="false" 
aria-label="Toggle navigation"> 
<span class="navbar -toggler-icon"></span> 
</button> 
<a class="navbar-brand" href="{% url 'index' %}">Rango</a> 


<div class="collapse navbar-collapse" id="navbar"> 
<ul class="navbar-nav mr-auto"> 
<li class="nav-item active"> 
<a class="nav-Link" href="{% url ‘index! %}"> 
Home 
</a> 
cf Lis 
<li class="nav-item"> 
<a class="nav-Link" href="{% url ‘about! %}"> 
About 
</a> 
a/is 
{% if user.is_authenticated %} 
<li class="nav-item"> 
<a class="nav-link" href="{% url 'restricted' %}"> 
Restricted Page 
</a> 
</li> 
<li class="nav-item"> 
<a class="nav-Link" href="{% url 'add_cateory' %}"> 
Add a New Category 
</a> 
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</lis 
<li class="nav-item"> 
<a class="nav-link" href="{% url 'auth_logout' %}?next=/rango/"> 
Logout 
</a> 
</lis 
{% else %} 
<li class="nav-item"> 
<a class="nav-link" href="{% url 'registration_register' %}"> 
Register Here 
</a> 
Us 
<li class="nav-item"> 


<a class="nav-link" href="{% url 'auth_login' %}"> 


Login 
</a> 
e/ las 
{% endif %} 
</ul> 
</div> 


</nav> 


<div class="container-fluid"> 
<div class="row"> 
<div class="col-sm-3 col-md-2 sidebar"> 
{% block sidebar_block %} 
{% get_category_list category %} 
{% endblock %} 
</div> 
<div class="col-sm-9 offset-sm-3 col-md-10 offset-md-2 main"> 
{% block body_block %}{% endblock %} 
</div> 
</div> 
</div> 


<!-- Bootstrap core JavaScript 


<!-- Placed at the end of the document so the pages load faster --> 
<script 

src="https://ajax.googleapis.com/ajax/libs/jquery/2.1.4/jquery.min. js"> 
</script> 
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<script 
src="http://v4-alpha.getbootstrap.com/dist/js/bootstrap.min. js"> 
</script> 
<!-- IE10 viewport hack for Surface/desktop Windows 8 bug --> 
<script 
src= 
"http: //v4-alpha.getbootstrap.com/assets/js/ie10-viewport-bug-workaround. js"> 
</script> 
</body> 
</html> 


创建 好 这 个 模板 之 后 ， 下 载 favicon ， 保 存 到 static/images/ 目录 中 。 


仔细 看 一 下 上 述 HTML 源码 ， 你 会 发 现 里 面 有 好 多 使 用 <div> 标签 创建 的 结构 。 整 个 页 面 基本 上 
分 为 两 部 分 ，<nav> 标签 里 的 顶部 导航 栏 和 <div class="container-fluid"> 标签 里 的 主 内 容 区 。 
主 内 容 区 里 还 有 两 个 <div> 标签 ， 分 别 放 置 sidebar_block 和 body_block 区 块 。 


注意 ， 这 个 HTML 模板 从 外 部 网 站 引用 CSS 和 JavaScript 文件 。 因 此 ， 为 了 正确 加 载 那些 文件 ， 


国 想 离线 工作 ? E 


除了 从 外 部 网 站 引用 CSS 和 JavaScript 文件 之 外 ， 还 可 以 下 载 相关 文件 ， 保 存 到 静态 文件 目 


录 中 。 如 果 你 选择 这 么 做 ， 别 忘 了 更 新 模板 中 对 这 些 文件 的 引用 地 址 。 


12.2 调整 模板 


接 下 来 还 要 做 些 调整 ， 把 base htm 模板 中 的 代码 蔡 换 为 base_bootstrap.html 中 的 代码 。 为 此 ， 可 
以 先 把 base html 中 现 有 的 代码 注释 掉 ， 然 后 复制 粘贴 base_bootstrap.himl 中 的 代码 。 


然后 刷新 网 页 ， 你 会 发 现 页 面 变 得 精美 多 了 。 以 关于 页 面 为 例 ， 修 改 前 后 的 对 比如 图 12-1 和 图 
12-2 所 示 。 


浏览 一 下 其 他 页 面 ， 因 为 都 继承 自 基 模板 ， 所 以 看 起 来 应 该 都 不 错 ， 但 也 有 不 足 之 处 。 接 下 来 我 
们 逐一 修改 各 页 面 的 模板 ， 使 用 Bootstrap 提供 的 CSS 类 改进 外 观 。 
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@@@ / [ Rango x a 
© © http://127.0.0.1:8000/rango/about/ 


About Rango 


This is Rango's about page. 
Click to return to the index page. 
Here's a picture of Rango! 


A 12-1: 没有 样式 的 关于 页 面 


首页 


首页 中 最 受 欢 迎 的 分 类 和 网 页 最 好 分 两 栏 显示 。 浏 览 Bootstrap 的 示例 后 我 们 发 现 ，Narrow Jum- 
botron 中 的 两 栏 就 符合 我 们 的 要 求 。 查 看 网 页 源码 ， 找 到 实现 分 栏 的 HTML 代码 : 


<div class="row marketing"> 
<div class="col-lg-6"> 
<h4>Subheading</h4> 
<p>Donec id elit non mi porta gravida at eget metus. 


Maecenas faucibus mollis interdum.</p> 
<h4>Subheading</h4> 
</div> 
<div class="col-lg-6"> 
<h4>Subheading</h4> 
<p>Donec id elit non mi porta gravida at eget metus. 


Maecenas faucibus mollis interdum. </p> 
</div> 
</div> 
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| eee B® Rango - How to Tango with Di x | David | 


= Œ | 127.0.0.1:8000/rango/about/ Wono Ọ : 
Rango 


About Page 


This is Rango's about page. 
You've visited this site on 1 occasion(s). 
Here's a picture of Rango! 


R: i sted kr und ati 
ango image hosted on flic| Der eativi 


| Commons licence = user elb agon 
i 


A 12-2: 集成 Bootstrap 后 的 关于 页 面 


<div class="row marketing"> 中 有 两 个 类 为 coL-1g-6 的 <div> 元 素 。Bootstrap 采用 栅 格 布局 ， 一 
个 容器 分 成 12 ft, col-1g-6 类 表明 所 在 的 分 栏 占 6 份 ， 即 容器 (<div class="row marketing">) 


宽度 的 一 半 。 


\ 


参照 上 述 代码 ， 修 改 index.html 模板 。 


{% extends 'rango/base.html' %} 
{% load staticfiles %} 
{% block title_block %} 
Index 
{% endblock %} 
{% block body_block %} 
<div class="jumbotron"> 
<h1 class="dispLay-3">Rango says...</h1> 
{% if user.is_authenticated %} 
<hi>hey there {{ user.username }}!</h1> 
{% else %} 
<hi>hey there partner! </h1> 
{% endif %} 
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</div> 
<div class="row marketing"> 
<div class="col-lg-6"> 
<h4>Most Liked Categories</h4> 
<p> 
{% if categories %} 
<ul> 
{% for category in categories %} 
<li><a href="{% url 'show_category' category.slug %}"> 
{{ category.name }}</a></li> 
{% endfor %} 
</ul> 
{% else %} 
<strong>There are no categories present.</strong> 
{% endif %} 
</p> 
</div> 
<div class="col-lg-6"> 
<h4>Most Viewed Pages</h4> 
<p> 
{% if pages %} 
<ul> 
{% for page in pages %} 
<li><a href="{{ page.url }}">{{ page.title }}</a></li> 
{% endfor %} 
</ul> 
{% else %} 
<strong>There are no categories present.</strong> 
{% endif %} 
</p> 
</div> 
</div> 
<img src="{% static "images/rango.jpg" %}" alt="Picture of Rango" /> 
{% endblock %} 


我 们 把 页 面 的 标题 放 在 <div class="jumbotron"> 中 ， 以 此 突出 显示 。 现 在 刷新 页 面 ， 看 起 来 好 多 
了 ， 不 过 列表 项 目 还 是 丑 。 


下 面 使 用 Bootstrap 提供 的 列表 组 样式 美化 一 下 。 修 改 方法 很 简单 ， 把 <ul> 元 素 改 成 <ul 
cLass="List-group">， 把 <li> 元 素 改 成 <Li class="list-group-item"> 即 可 。 再 次 刷新 页 面 ， 现 
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在 好 点 了 吧 ? 


eee a") Rango - How to Tango with D x David 


€ CŒ | © 127.0.0.1:8000/rango/ wono Q : 


Rango says... 


hey there partner! 
Most Liked Categories Most Viewed Pages 
There are no categories present. There are no categories present. 


Window size: 1013 x 622 
Viewport size: 1013 x 548 


图 12-3: 添加 超大 标题 和 分 栏 后 的 首页 


登录 页 面 


接 下 来 修改 登录 页 面 。Bootstrap 网 站 中 有 个 不 错 的 登录 表单 。 查 看 网 页 源码 ， 你 会 发 现 我 们 要 在 
现 有 的 表单 中 添加 几 个 类 才能 实现 演示 的 效果 。 人 参照 下 述 代码 更 新 login htm 模板 中 的 
body_block 区 块 。 


{% block body_block %} 
<link href="http://v4-alpha.getbootstrap.com/examples/signin/signin.css" 
rel="stylesheet"> 
<div class="jumbotron"> 
<h1 class="dispLay-3">Login</h1> 
</div> 
<form class="form-signin" role="form" method="post" action="."> 
{% csrf_token %} 
<h2 class="form-signin-heading">Please sign in</h2> 
<label for="inputUsername" class="sr-only">Username</label> 
<input type="text" name="username" id="id_username" class="form-controLl" 


placeholder="Username" required autofocus> 
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<label for="inputPassword" class="sr-only">Password</label> 
<input type="password" name="password" id="id_password" class="form-controL" 
placeholder="Password" required> 
<button class="btn btn-lg btn-primary btn-block" type="submit" 
value="Submit" />Sign in</button> 
</form> 
{% endblock %} 


除了 引入 signin.css 样式 表 ， 修 改 一 些 CSS 类 之 外 ， 我 们 还 删除 了 自动 生成 表单 元 素 的 代码 ， 即 
form.as_p。 现 在 ， 各 表单 元 素 及 其 id 都 由 我 们 自己 编写 。 注 意 ， 表 单元 素 的 id 十 分 重要 。 为 了 
找 出 各 表单 元 素 的 id， 可 以 查看 修改 之 前 的 登录 页 面 源码 ， 即 使 用 form.as_p 模板 标签 生成 的 
HTML, 


我 们 把 按钮 的 CSS 类 设 为 btn 和 btn-primary。 在 文档 中 可 以 看 到 ，Bootstrap 为 按钮 提供 了 大 量 
不 同 的 颜色 、 大 小 和 样式 。 


@ © @ / gJ Rango - How to Tango with Di- x David 
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Login 


Please sign in 


Not a member? Register! 


图 12-4: 集成 Bootstrap 后 的 登录 页 面 


其 他 有 表单 的 模板 


参照 登录 页 面 修改 add_cagegory.html 和 add_page html 模板 。 修 改 后 的 add_page html 模板 如 下 。 


{% extends "rango/base.html" %} 
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{% block title %}Add Page{% endblock %} 


{% block body_block %} 
{% if category %} 
<form role="form" id="page_form" method="post" 
action="/rango/category/{{category.slug}}/add_page/"> 
<h2 class="form-signin-heading"> Add a Page to 
<a href="/rango/category/{{category.slug}}/"> 
{{ category.name }}</a></h2> 
{% csrf_token %} 
{% for hidden in form.hidden_fields %} 
{{ hidden }} 
{% endfor %} 
{% for field in form.visible_fields %} 
{{ field.errors }} 
{{ field.help_text }}<br/> 
{{ field }}<br/> 
{% endfor %} 
<br/> 
<button class="btn btn-primary" 
type="submit" name="submit"> 
Add Page 
</button> 
</form> 
{% else %} 
<p>This is category does not exist.</p> 
{% endif %} 
{% endblock %} 


</> 练习 


口 以 类 似 的 方式 修改 add_category.himl 模板 。 


注册 页 面 


registration_form.himl 模板 中 的 表单 可 以 像 下 面 这 样 修改 。 
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{% extends "rango/base.html" %} 
{% block body_block %} 


<h2 class="form-signin-heading">Sign Up Here</h2> 


<form role="form" method="post" action="."> 
{% csrf_token %} 
<div class="form-group" > 
<p class="required"><Label class="required" for="id_username"> 
Username:</lLabel> 
<input class="form-control" id="id_username" maxlength="30" 
Name="username" type="text" /> 
<span class="helptext"> 
Required. 30 characters or fewer. Letters, digits and @/./+/-/_ only. 
</span> 
</p> 
<p class="required"><Label class="required" for="id_email"> 
E-mail:</label> 
<input class="form-control" id="id email" name="email" 
type="email" /> 
</p> 
<p class="required"><Label class="required" for="id_password1"> 
Password:</lLabel> 
<input class="form-control" id="id_passwordi" name="password1" 
type="password" /> 
</p> 
<p class="required"> 
<label class="required" for="id_password2"> 
Password confirmation:</label> 
<input class="form-control" id="id_password2" name="password2" 
type="password" /> 
<span class="helptext"> 
Enter the same password as before, for verification. 
</span> 
</p> 
</div> 
<button type="submit" class="btn btn-defauLt">Submit</button> 
</form> 
{% endblock %} 
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同样 ， 我 们 删 掉 了 {{ form.as_p }} 模板 标签 ， 各 表单 元 素 及 其 CSS 类 都 是 自己 动手 编写 的 。 


David | | 
一 一 一 | 


© © @ / B® Rango - How to Tango with D) x 
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Register Here 


Username: Required. 30 characters or fewer. Letters, digits and @/./+/-/_ only. 
Email: email address 

Password: 

Password confirmation: Enter the same password as before, for verification. 


Submit 


图 12-5: 集成 Bootstrap 后 的 注册 页 面 


4 竹 脚 的 集成 方式 人 


这 不 是 集成 Bootstrap 的 最 好 方式 ， 如 果 能 让 Django 在 构建 HTML 时 自动 插入 相关 的 CSS 
类 就 好 了 。 


12.3 使 用 Django-Bootstrap-Toolkit 


除了 自己 动手 集成 之 外 ， 还 可 以 使 用 django-bootstrap-toolkit 这 样 的 包 。 先 使 用 pip 安装 : 
$ pip install django-bootstrap-toolkit 
然后 打开 settings py 模块 ， 把 bootstrap_toolkit 添加 到 INSTALLED_APPS 中 。 


为 了 在 模板 中 使 用 这 个 包 ， 首 先 要 使 用 load 模板 标签 加 载 它 ({% load bootstrap_toolkit 
%}) ， 然 后 调用 一 个 函数 ， 更 新 生成 的 HIML， 即 {{ form|as_bootstrap }}。 按 照 下 述 代码 更 新 
add_category.html 模板 。 


{% extends "rango/base.html" %} 


{% load bootstrap _toolkit %} 
{% block title %}Add Category{% endblock %} 
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{% block body _block %} 
<form id="category_form" method="post" 
action="{% url 'add_category' %}"> 
<h2 class="form-signin-heading">Add a Category</a></h2> 
{% csrf_token %} 
{{ form|as_bootstrap }} 
<br/> 
<button class="btn btn-primary" type="submit" 
name="submit">Create Category</button> 
</form> 
{% endblock %} 


这 样 得 到 的 模板 更 简洁 ， 而 且 自 动 化 程度 更 高 ， 但 是 泻 染 结果 没有 手动 集成 的 细致 ， 因 此 还 要 做 
些 调整 和 定制 。 


12.4 接 下 来 


本 章 简要 说 明了 如 何 使 用 Bootstrap 装饰 Django 应 用 。Bootstrap 是 个 高 度 可 扩展 的 框架 ， 能 轻易 
更 改 整体 风格 。StartBootstrap 网 站 中 有 很 多 不 同 的 风格 。 


除了 Bootstrap 之 外 ， 还 有 很 多 CSS 框架 可 用 ， 例 如 Zurb Foundation, Titon, Pure, GroundWorkd 
和 BassCSS 。 


知道 如 何 修改 模板 ， 实 现 啊 应 式 设 计 之 后 ， 下 面 回归 正题 ， 继 续 为 Rango 应 用 添加 功能 。 


</> 练习 


本 书 使 用 的 是 Bootstrap ， 如 果 你 有 时 间 ， 可 以 试 着 使 用 其 他 响应 式 CSS 框架 装饰 Rango 应 
用 。 当 然 ， 你 也 可 以 自己 设计 。 如 果 你 觉得 自己 设计 的 不 错 ， 请 告诉 我 们 |! 
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Webhose 搜索 


至 此 ，Rango 应 用 的 核心 功能 已 经 实现 ， 接 下 来 该 考虑 一 些 高 级 功能 了 。 本 章 将 使 用 Webhose 
API 实现 搜索 网 页 的 功能 ， 毕 况 只 能 按 分 类 浏览 不 是 很 方便 。 为 此 ， 我 们 需要 注册 Webhose 账 
户 ， 再 编写 一 个 包装 脚本 (wrapper) ， 通 过 API 获取 查询 结 


13.1 Webhose API 


a Oa 其 功能 是 汇集 众多 在 线 源 ， 实 时 整理 信息 。 借 助 Webhose API， 我 们 
能 以 编程 的 方式 查询 Webhose， 得 到 ISON 格式 的 结果 。 返 回 的 数据 经 过 JSON 解析 器 解释 后 ， 
EML RERE., 


Webhose CARRI AEZ G, (AMA ERNE. RNI H KER Rango 应 用 的 用 户 输 
入 的 词 条 搜索 到 的 网 页 。 使 用 Webhose API 之 前 ， 要 有 API EH. ATEH, RIEA N 
费 查 询 一 千 次 一 一 这 对 我 们 的 演示 应 用 而 言 足够 了 。 


x 应 用 程序 编程 接口 是 什么 ? * 


应 用 程序 编程 接口 (Application Programming Interface，API) 定义 软件 组 件 之 间 的 交互 方 


st, Xt Web 应 用 来 说 ，API 可 以 理解 为 一 系列 HTTP 请 求 及 其 响应 消息 的 结构 。 任 何 能 通过 
互联 网 访问 的 服务 都 可 以 有 API， 本 章 涉 及 的 是 搜索 API。 如 果 想 进一步 了 解 Web API， 可 
以 阅读 Luis Rei 写 的 这 篇 优秀 教程 。 


注册 Webhose API 248 


为 了 获得 Webhose API 密 钥 ， 首 先 要 注册 一 个 免费 的 Webhose 账户 。 在 Web 浏览 器 中 访问 
https://www.webhose.io, Kit mimi LAW Use it for free” 按 钮 注册 。 公 司 名 称 无 需 填 写 ， 工 作 邮 
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箱 填 一 个 有 效 的 电子 邮件 地 址 即 可 。 


注册 好 账户 后 ， 打 开 Webhose 的 控制 面板 ， 如 图 13-1 所 示 。 在 这 个 页 面 可 以 看 到 当月 已 经 使 用 
的 查询 次 数 ， 以 及 还 剩 多 少 免费 额度 。 此 外 ， 页 面 
Webhose 的 次 数 。 向 下 拉 深 动 条 ， 找 到 “Active API Key 部分。 把 这 里 显示 的 密 钥 复制 到 一 个 空 文 


本 文件 中 ， 以 备 后 用 。 这 是 你 专用 的 密 钥 ， 通 过 它 对 Webhose API 的 请 求 都 算 在 你 名 下 。 


图 13-1: Webhose 的 控制 面板 ， 显 示 API 密 钥 的 位 置 。 你 可 能 要 向 下 拉动 滚动 条 才能 看 到 。 上 图 


记 下 API 密 钥 后 ， 点 击 顶 部 导航 栏 中 的 "API Playground 链接 。 这 个 页 面 供 你 试用 Webhose API 


@ © @ / æ Webhose.io - Dashboard x David 


€ > Œ | â Secure https://webhose.io/dashboard wong G @ : 


webhose.io Dashboard  UseWebhose.io~ Resources ~ Pricing Help Blog | David Maxw... ~ 


Requests Used 


Create a new query 
Active API Key 
Your API Key ARROSER R 


中 的 API FAR AET, ERRIPA A ELARA 


接口 ， 你 可 以 自己 尝试 一 下 。 


© © © © 


在 “Define the query” 下 面 的 方 框 中 输入 一 个 词 条 。 
在 “Sort By” FAAP Relevancy”, 
“Crawled Since” H Fix ze 1 E ARERR, RAE 3 天 就 可 以 。 


点 击 "Run 按钮 。 稍 等 片刻 页 面 中 便 会 出 现 查 询 结果 。 图 13-2 是 搜索 “Glasgow” 得 到 的 结 
Ao 
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中 还 有 一 个 图 表 ， 展 示 了 一 段 时 间 内 你 查询 


© © @ / æ Use the API x David 


€ CŒ © https://webhose.io/api tenggo: 


webhose.io Dashboard Use Webhoseio ~ Resources ~ Pricing Help Blog | David Maw... ~ 


Output Stream 


Visual Glimpse JSON 


Found 6,907 posts matching your filters from the past 3 days. 
The posts are ordered for consumption by crawl date, from oldest to newest. To learn more about how to consume the data, click here. 


Trump protest signs 


Published at: 1/31/2017 2:00 PM @ bbc.co.uk 


GONNAE | 
NO DAE 


Read more about sl eh Close share panel Image caption The BBC's Lorna G 
President's trave ‘ottish cities hosted protests against US President Don. 
distinctly Scottish Steud 


this lady from Georgia in the 
's travel ban on Monday night 


's angry and ashamed about the 
of the protesters brought a 


Post number: 1 Total Posts: 1 Country: GB Site Type: news Performance Score: 9 


Glasgow School of Art's ashes turned into artworks to fund rebuild | Education 


Published at: 2/1/2017 12:00 AM, By: Hannah Ellis-Petersen @ th 


Some of the biggest nam m Grayson Perry to Anish Kapoor and Antony Gormley, have created artworks from the ashes of Glasgow School of Art to help 
raise funds for the building's restoration. The school was gutted by a fire in May 2014 , and as part of an appeal towards resurrecting the historic Mackintosh 
building , artists were sent th. 


Test a new Query 


图 13-2: 通过 Webhose API 查询 “Glasgow” 得 到 的 响应 。 除 了 原始 的 JSON 响应 之 外 ， 还 有 预览 。 


看 一 下 Webhose API 返回 的 结果 ， 以 及 原始 的 JSON 啊 应 。 


向 上 拉动 滚动 条 ， 找 到 “Endpoint" 框 。 这 里 显示 的 URL 就 是 我 们 的 应 用 将 要 使 用 的 查询 端点 。 下 
面 是 一 个 端点 URL 示例 : 


http: //webhose.io/filterWebContent?token=<KEY&format=json&sort=reLevancy&q=<QUERY> 


~ URL 可 以 分 为 两 部 分 ， 问 号 左边 是 基 URL， 右 边 是 查询 字符 串 。 基 URL 相当 于 API 的 路 

， 而 查询 字符 串 是 一 系列 键 值 对 (例如 format 是 键 ，json 是 值 ) ， 用 于 告诉 API 你 想 做 什 

。 在 后 面 的 示例 代码 中 你 会 看 到 ， 我 们 将 以 这 种 方式 分 拆 URL， 构 建 好 查询 字符 串 之 后 再 合 在 
as 构成 完整 的 请 求 URL。 


13.2 添加 搜索 功能 


得 到 Webhose API 密 钥 后 ， 可 以 开始 编写 Python 代码 ， 向 Webhose API 发 起 查询 请 求 了 。 在 ran- 
go 目录 中 新 建 一 个 模块 (文件 ) ， 命名 为 webhose_search.py, SAF 述 代码 ，。 注意 选择 正确 的 
Python 版 本 。 正 如 前 文 所 说 ， 不 要 盲目 复制 烙 贴 ， 最 好 自己 动手 输入 ， 这 样 在 输入 的 过 程 中 你 才 
会 思考 代码 的 作用 。 
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* Python 2 和 3 之 间 的 区 别 六 


Python 3 重 构 了 urLLib 包 ,， 连接 和 处 理 外 部 Web 资源 的 方式 变 了 。 下 面 分 别 给 出 针对 


Python 2.7 和 Python 3 的 代码 。 请 根据 你 的 环境 选择 正确 的 代码 。 


Python 2 版 
1 import json 
2 import urllib 
3 import urllib2 
4 
5 def read_webhose_key(): 
6 nun 
7 从 search.key 文件 中 读 取 Webhose API 384A 
8 返回 None (未 找到 密 钥 ) ， 或 者 密 钥 的 字符 串 形 式 
9 注意 ,把 search.key BA .gitignore 文件 ， 禁 止 提交 
10 
11 # 参见 Python Anti-Patterns 小 书 ， 这 是 一 份 十 分 优秀 的 资料 
12 # 使 用 with 打开 文件 
13 # http://docs.quantifiedcode.com/python-anti-patterns/maintainability/ 
14 webhose_api_key = None 
15 
16 try: 
17 with open('search.key', 'r') as f: 
18 webhose_api_key = f.readline().strip() 
19 except: 
20 raise I0Error('search.key file not found') 
21 
22 return webhose_api_key 
23 
24 def run_query(search_terms, size=10): 
25 E 
26 指定 搜索 词 条 和 结果 数量 (默认 为 10), Æ Webhose API 返回 的 结果 存 入 列表 
27 每 个 结果 都 有 标题 、 链 接地 址 和 摘要 
28 wee 
29 webhose_api_key = read_webhose_key() 


1. http://stackoverflow.com/a/2792652 
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30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 


if not webhose_api_key: 


raise KeyError('Webhose key not found') 


# Webhose API 的 基 URL 


root_url = 'http://webhose.io/search' 


# 处 理 查询 字符 串 ， 转 义 特 殊 字 符 
query_string = urllib.quote(search_terms) 


# 使 用 字符 串 格式 化 向 法 构建 完整 的 API URL 
# search_url 是 一 个 多 行 字符 串 


search_url = ('{root_url}?token={key }&format=json&q={query}' 


'&sort=relevancy&size={size}').format( 
root_url=root_url, 
key=webhose_api_key, 
query=query_string, 


size=size) 
results = [] 
try: 
# 连接 Webhose API， 把 响应 转换 为 Python 字典 
response = urllib2.urlopen(search_url).read() 


json_response = json.loads(response) 


# 迁 代 文章 ， 把 一 篇 文章 作为 一 个 字典 追加 到 结果 列表 中 


# 限制 摘要 的 长 度 为 200 个 字符 ， 因 为 Webhose 返回 的 摘要 可 能 很 长 


for post in json_response['posts']: 
results.append({'title': post['title'], 
"Link': post['url'], 
‘summary': post['text'][:200]}) 
except: 


print("Error when querying the Webhose API") 


H 把 结果 列表 返回 给 调用 方 
return results 
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Python 3 版 本 


1 import json 

2 import urllib.parse # Py3 

3 import urllib.request # Py3 

4 

5 def read _webhose key(): 

6 nnn 

7 从 search.key 文件 中 读 取 Webhose API 384A 

8 返回 None (未 找到 密 钥 ) ， 或 者 密 钥 的 字符 串 形 式 

9 注意 ,把 search.key BA .gitignore 文件 ， 禁 止 提交 
10 
11 # 参见 Python Anti-Patterns 小 书 ， 这 是 一 份 十 分 优秀 的 资料 
12 # 使 用 with 打开 文件 
13 # http://docs.quantifiedcode.com/python-anti-patterns/maintainability/ 
14 webhose_api_key = None 
15 
16 LEYS 
17 with open('search.key', 'r') as f: 
18 webhose_api_key = f.readline().strip() 

19 except: 

20 raise I0Error('search.key file not found') 
21 

22 return webhose_api_key 

23 
24 def run_query(search_terms, size=10): 

25 Wi 

26 指定 搜索 词 条 和 结果 数量 (默认 为 10) ， 把 Webhose API 返回 的 结果 存 入 列表 
27 每 个 结果 都 有 标题 、 链 接地 址 和 摘要 

28 Pei 
29 webhose_api_key = read_webhose_key() 
30 
31 if not webhose_api_key: 
32 raise KeyError('Webhose key not found') 
33 
34 # Webhose API 的 基 URL 
35 root_url = 'http://webhose.io/search' 
36 
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37 # 处 理 查询 字符 囊 ， 转 义 特殊 字符 


38 query_string = urllib.parse.quote(search_terms) # Py3 

39 

40 H 使 用 字符 串 格 式 化 句法 构建 完整 的 API URL 

41 # search_url 是 一 个 多 行 字 符 囊 

42 search_url = ('{root_url}?token={key }&format=json&q={query}' 
43 '&sort=reLlevancy&size={size}').format( 

44 root_url=root_url, 

45 key=webhose_api_key, 

46 query=query_string, 

47 size=size) 

48 

49 results = [] 

50 

51 TRY 

52 # 连接 Webhose API， 把 响应 转换 为 Python 字典 

53 response = urllib.request.urlopen(search_url).read().decode('utf-8') 
54 json_response = json.loads(response) 

55 

56 # 选 代 文 章 ， 把 一 篇 文章 作为 一 个 字典 追加 到 结果 列表 中 

57 # 限制 摘要 的 长 度 为 200 个 字符 ， 因 为 Webhose 返回 的 摘要 可 能 很 长 
58 for post in json_response['posts']: 

59 results.append({'title': post['title'], 

60 "Link': post['url'], 

61 ‘summary': post['text'][:200]}) 

62 except: 

63 print("Error when querying the Webhose API") 

64 

65 # 把 结果 列表 返回 给 调用 方 

66 return results 


上 述 代 码 清单 实现 了 两 个 函数 : read_webhose_key() 函数 从 本 地 文件 中 读 取 Webhose API 密 钥 ， 
run_query() 函数 向 Webhose API 发 送 请 求 ， 返 回 得 到 的 结果 。 下 面 分 析 一 下 这 两 个 函数 。 


read_webhose_key(). 读 取 Webhose API 密 钥 


read_webhose_key() 函数 从 名 为 search.key 的 文件 中 读 取 Webhose API 密 钥 。 这 个 文件 应 该 放 在 
Django 项 目的 根 目 录 中 ( 即 <workspace>/tango_with_django_project/) ， 而 不 是 Rango 应 用 的 目 
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录 中 。 单 独 定义 这 样 一 个 函数 ， 是 为 了 把 读 取 和 使 用 API 密 钥 的 代码 分 开 。 如 果 代码 是 公开 共享 
的 ， 这 么 做 的 好 处 就 凸显 出 来 了 ， 毕 竞 我 们 不 想 让 别人 使 用 自己 的 API 密 钥 。 


现在 请 创建 search.key 文件 。 把 之 前 复制 的 API 密 钥 保存 到 这 个 文件 中 。 这 个 文件 只 用 于 存储 密 

钥 ， 不 能 有 任何 其 他 内 容 。 为 了 防止 把 这 个 文件 提交 到 GitHub 仓库 ， 更 新 .gitignore 文件 ， 添 加 

*.key， 排 除 所 有 扩展 名 为 key 的 文件 。 这 样 密 钥 就 只 存在 于 本 地 ， 不 会 意外 提交 到 远程 Git 仓库 
中 。 


密 钥 一 定 要 保护 好 ， 不 能 让 他 人 摆 取 ! 


别 让 别人 使 用 你 的 密 钥 。 如 果 使 用 不 当 ， 对 应 的 服务 可 能 取消 你 的 使 用 权限 。 更 糟 的 是 ， 如 
果 是 付费 用 户 ， 你 要 额外 支付 大 量 费 用 。 


run_query(), 执行 查询 


run_query() 函数 接受 两 个 参数 : search_terms， 值 为 字符 串 ， 表 示 用 户 输入 的 搜索 词 条 ，size， 
可 选 ， 默 认为 09， 控制 Webhose API 返回 的 结果 数量 。run_query() 函数 与 Webhose API 通信 ， 
返回 一 个 由 Python 字典 构成 的 列表 ， 每 个 字典 表示 一 个 结果 (有 title, Link 和 summary) 。 上 
述 代码 清单 中 的 注释 解释 了 每 一 步 操作 ， 如 果 想 进一步 理解 代码 ， 请 阅读 注释 。 


run_query() 函数 的 逻辑 大 致 可 以 分 成 7 个 任务 ， 说 明 如 下 。 


O 首先 ， 调 用 read_webhose_key() 函数 ， 获 取 Webhose API, 


@ 然后 构建 要 发 给 API 的 查询 字符 串 。 这 里 要 编码 URL， 把 特殊 的 字符 〈 例 如 空格 ) 转换 成 
Web 服务 器 和 浏览 右 能 理解 的 格式 。 比 如 ， 空 格 会 转换 成 %20。 


© 根据 Webhose API 文档 ， 接 下 来 拼接 编码 后 的 search_terms 字符 串 和 size 参数 ， 以 及 
Webhose API 密 钥 ,构建 请 求 Webhose API 的 完整 URL, 


@ 然后 使 用 Python urllib2 (Python 2.7.x) 或 urllib 模块 连接 Webhose API。 服 务 器 的 啊 应 
存 为 response 变量 。 
© 使 用 Python json 库 把 啊 应 转换 成 Python 字典 对 象 。 


O ARFER, HE Webhose API 返回 的 各 个 结果 以 字典 (包含 title, Link 和 summary 键 值 
对 ) 为 单位 存 人 results 列表 。 


@ 返回 results 列表 。 
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* 研究 API 选项 * 


使 用 新 API 时 最 好 研究 一 下 文档 ， 看 有 哪些 选项 可 用 。 建 议 你 研究 一 下 Webhose API 文档 。 


</> 练习 


扩展 webhose_search.py 模块 ， 让 它 可 以 独立 运行 ， 即 可 以 在 终端 或 命令 提示 符 中 运行 python 
webhose_search.py， 而 无 需 启动 Django 开发 服务 器 。 为 此 你 要 : 


J 要 求 用 户 输入 查询 词 条 (使 用 raw_input()) 
J 通过 run_query() 发 起 查询 ， 然 后 打印 结 


把 每 个 结果 的 title 和 summary 打印 出 来 ， 而 且 两 个 结果 之 间 有 换行 。 


此 外 还 要 修改 read_webhose_key() 函数 ， 以 便 运行 webhose_search py 脚本 时 能 找到 rango H 
录 中 的 search.key 文件 。 运 行 Django 开发 服务 器 时 ，Python 期 望 能 在 启动 manage py 脚本 的 
目录 中 找到 search.key 文件 。 直 接 运 行 rango 目录 中 的 webhose_search py 脚本 时 ， 要 到 上 一 
层 目录 中 查找 search key 文件 。 那 么 应 该 如 何 修改 read_webhose_key() 函数 才能 同时 在 两 种 
情况 下 使 用 呢 ? 


如 果 你 是 在 Windows 电脑 上 使 用 Python 2.7.x 开发 的 ， 要 使 用 encode() 函数 以 UTF-8 格式 编 
码 print 打印 的 内 容 。 例 如 ， 打 印 结果 的 title 时 ， 要 使 用 
print(result['title']).encode('utf-8')。 如 果 遇 到 UnicodeEncodeError 错误 ， 可 能 就 要 这 
Afi. Python 3 不 受 这 个 问题 影响 。 


前 面 在 填充 脚本 中 已 经 这 么 做 过 了 。 你 可 以 试 着 遵守 Google 的 Python 编程 风格 指南 ， 添 加 
main() 函数 ， 通 过 它 调用 一 切 。 此 外 ， 还 需要 下 面 两 行 代码 。 如 果 你 不 知道 这 两 行 代 码 的 作 
用 ， 请 看 这 个 在 线 解 答 ， 或 者 翻 回 5.7 市 。 


if _ name == ' _ main_': 


main() 


添加 这 两 行 代码 后 ， 模 块 便 可 以 独立 运行 ， 而 且 通 过 import 导入 到 其 他 Python 程序 中 ， 其 
中 的 代码 也 不 会 自动 执行 。 
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修改 read_webhose_key() 函数 的 方法 有 很 多 ， 其 中 最 简单 的 应 该 是 使 用 os.path.isfite() K 
数 检 查 当 前 目录 中 有 没有 search.key 文件 。 如 果 没 有 ， 那 就 可 以 假定 密 钥 的 路 径 是 
.searchn.key， 即 在 运行 脚本 的 上 一 层 目录 中 。 为 了 使 用 isfile() 函数 ， 要 在 web- 
hose_search py 模块 的 顶部 导入 os 模块 。 


13.3 集成 到 Rango 应 用 中 


在 webhose_search py 模块 中 实现 搜索 功能 后 ， 接 下 来 要 把 它 集成 到 Rango 应 用 中 。 这 个 过 程 主要 
分 三 步 : 


O 创建 search.html 模板 ， 扩 展 自 base.html AQ, search html 模板 中 有 个 HTML 表单 ， 收 集 
用 户 输入 的 查询 词 条 ， 以 及 用 于 呈现 结果 的 模板 代码 。 

@ 编写 一 个 Django 视图 ， 调 用 前 面 定义 的 run_query() 函数 ， 演 染 search.html 模板 。 

© FE Rango 应 用 的 urls py 模块 中 把 新 视图 映射 到 一 个 URL 上 。 


创建 模板 


首先 创建 search.html 模板 。 把 这 个 模板 放 在 项 目 templates 目录 中 的 rango 目录 里 。 在 文件 中 写 人 
下 述 HTML 标记 和 Django 模板 代码 。 


{% extends 'rango/base.html' %} 
{% load staticfiles %} 


{% block title %} Search {% endblock %} 


6 {% block body block %} 
<div> 
<hi>Search with Rango</h1> 
<br/> 
10 <form class="form-inline" id="user_form" 
method="post" action="{% url 'search' %}"> 
{% csrf_token %} 
<div class="form-group"> 
<input class="form-controLl" type="text" size="50" 


name="query" value="" id="query" /> 
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16 </div> 


17 <button class="btn btn-primary" type="submit" name="submit" 
18 value="Search">Search</button> 

19 </form> 

20 

21 <div> 

22 {% if result_list %} 

23 <h3>Results</h3> 

24 <!-- 按 顺序 显示 搜索 结果 --> 

25 <div class="list-group"> 

26 {% for result in result_list %} 

27 <div class="list-group-item"> 

28 <h4 class="List-group-item-heading"> 

29 <a href="{{ result.link }}">{{ result.title }}</a> 
30 </h4> 

31 <p class="List-group-item-text">{{ result.summary }}</p> 
32 </div> 

33 {% endfor %} 

34 </div> 

35 {% endif %} 

36 </div> 

37 </div> 


38 {% endblock %} 
上 述 模板 代码 主要 执行 两 个 任务 : 


J 在 HIML 表单 中 显示 搜索 框 和 搜索 按钮 ， 供 用 户 输入 和 提交 查询 词 条 。 

J 演 染 模板 时 ， 如 果 传 给 模板 上 下 文 的 results_list 对 和 象 有 内 容 ， 那 就 迭代 results_list 对 
象 ， 演 染 里 面 的 结果 。 上 述 模 板 期 望 每 个 结果 中 有 title, link 和 summary， 这 与 前 面 定义 
的 run_query() 函数 是 一 致 的 。 


在 样式 方面 ， 我 们 使 用 了 Bootstrap 的 列表 组 和 行内 表单 。 


下 一 小 结 定义 的 Django 视图 将 通过 results_list 上 下 文 变量 把 搜索 结果 传 给 模板 。resuLts_List 
一 开始 为 空 ， 因 此 未 搜索 到 结果 时 模板 不 会 泻 染 后 半 部 分 。 
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编写 视图 


创建 好 模板 后 ， 接 下 来 要 添加 视图 ， 浑 染 模板 。 在 Rango 应 用 的 views py 模块 中 添加 下 述 
search() 视图 。 


def search(request): 
result list = [] 


if request.method == 'POST': 
query = request.POST[ 'query'].strip() 
if query: 
# 调用 前 面 定义 的 函数 向 Webhose 发 起 查询 ， 获 得 结果 列表 


resuLt_list = run_query(query) 


return render(request, 'rango/search.html', {'result_list': result_list}) 


学 到 现在 ， 你 应 该 能 理解 上 述 代码 了 。 这 里 唯一 需要 注意 的 地 方 是 对 run_query() 函数 的 调用 。 
为 此 ， 我 们 要 导入 webhose_search.py 模块 。 在 运行 Django 开发 服务 之 前 ， 请 把 下 述 import 语句 
添加 到 Rango 应 用 的 views.py 模块 顶部 。 


from rango.webhose_search import run_query 


添加 映射 


接 下 来 要 把 search() 视图 映射 到 一 个 URL 上 ， 还 要 在 导航 栏 中 添加 一 个 链接 ， 让 用 户 能 找到 搜 
索 页 面 。 


D 把 search() 视图 映射 到 URL /rango/search/ 上 ， 并 设 定 name='search' 参数 。 即 ， 在 Rango 
应 用 的 urls.py 模块 中 添加 url(r'search/$', views.search, name='search'), 


J 更 新 base heml 模板 中 的 导航 栏 ， 加 入 搜索 页 面 的 链接 。 不 要 在 模板 中 硬 编 码 URL， 应 该 
使 用 url 模板 标签 。 


最 后 提醒 一 下 ， 不 要 忘 了 在 Django 项 目的 根 目录 中 创建 search.key 文件 ， 写 人 你 的 Webhose API 
BH 


现在 可 以 向 Webhose API 发 起 查询 了 ， 如 图 13-3 所 示 。 
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127.0.0.1 © E 


A . 
on Search with Rango 
Frameworks 
e Python User 
Groups Results 
e Pascal 
© Perl Python For Noob’s 
e Perl Mongers Python For Noob's . Pages. blogroll. About.me; Contato; social. Facebook; Twitter; Github; Powered by Pelican. 


Theme blueidea, inspired by the default theme. ... 


Python for noobs - Hello world! - YouTube 

Buy Hello world book: http://www.amazon.com/Hello-World-Com... Subscribe, rate. and check out the channels of 
the other squids 

BeginnersGuide/NonProgrammers - Python Wiki 


Python for Non-Programmers. If you've never programmed before, the tutorials on this page are recommended for 
you; they don't assume that you have previous experience. 


python - Design principles for complete noobs? - Stack ... 


I've been programming for around a year now, and all the stuff that I've written works - it's just extremely poorly 
written from my point of view. I'd like to know if ... 


Python Beginner Tutorial 1 (For Absolute Beginners) - YouTube 
This Python Programming Tutorial covers the instillation python and setting up the python development environment. 
This video covers setting up a system ... 


图 13-3: 搜索 “Python for Noobs” 4¥ 21 49 25 RK 
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你 可 能 注意 到 了 ， 显 示 结 果 时 ， 搜 索 词 条 不 见 了 ， 这 对 用 户 不 太 友 好 。 修 改 search() 视图 和 
search.html 模板 ， 在 搜索 框 中 显示 用 户 输 入 的 词 条 。 


在 视图 中 ， 要 把 query 传人 上 下 文人 字典。 在 模板 中 ， 要 在 搜索 框 中 显示 查询 词 条 。 
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中 期 练习 


我 们 一 点 一 点 ， 为 Rango 应 用 增加 了 一 些 功能 。 之 所 以 每 次 只 增加 
Django 框架 ， 学 习 应 用 程序 的 各 部 分 是 如 何 组 织 的 。 然 而 ，Rango 


而 且 缺 少 交互 性 。 本 章 将 给 你 一 些 挑战 ， 证 你 自己 动手 改进 ， 结 合 
高 应 用 的 用 户 体验 。 


为 了 丰富 Rango 应 用 的 功能 ， 提 升 交互 性 ， 最 好 再 加 上 下 述 功 能 。 


口 统计 分 类 和 网 页 的 相关 数据 


。 分 类 的 查看 次 数 
”网 页 的 访问 次 数 
”分 类 的 点 赞 次 数 (参见 第 16 章 ) 


D 在 分 类 页 面 中 集成 过 滤 和 搜索 功能 


。 删 掉 独 立 的 搜索 页 面 ， 让 用 户 在 分 类 页 面 驶 能 搜索 网 页 
”让 用 户 过 滤 分 类 ， 结 果 显 示 在 侧 边栏 中 (参见 第 16 章 ) 


A 为 注册 用 户 提供 以 下 服务 


。 假设 你 已 经 换 用 django-registration-redux， 修 改 注 册 表 单 


像 ) 
。 让 用 户 查 看 自己 的 个 人 资料 
”让 用 户 编辑 自己 的 个 人 资料 
。 让 用 户 查 看 用 户 列表 及 其 他 用 户 的 个 人 资料 


一 个 功能 ， 是 为 了 证 你 熟悉 
应 用 的 功能 目前 还 有 些 松散 ， 
现 有 的 功能 和 一 些 新 功能 ， 提 


， 收 集 额 外 的 信息 《网 站 和 头 
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现在 不 一 一 实现 这 些 功能 ， 有 成 ， 有 些 则 留 作 练习 。 


着 手 添加 功能 之 前 最 好 列 出 要 做 的 事 ， 思 考 如 何 完 成 各 个 任务 。 把 一 项 任务 分 解 为 一 系列 小 任务 
能 简化 实现 过 程 ， 各 个 击破 。 本 章 将 给 出 部 分 任务 的 解决 思路 。 结 合 目前 所 学 的 知识 ， 你 应 该 能 
自行 实现 多 数 功能 (用 到 Ajax 的 除外 ) 。 附 录 B 将 给 你 一 些 提示 和 代码 片段 ， 说 明 如 何 实现 这 
些 功 能 。 当 然 ， 如 果 你 真 的 不 知道 如 何 实现 ， 随 时 可 以 查看 GitHub 仓库 中 的 代码 。 


14.1 记录 网 页 的 访问 次 数 


目前 ，Rango 直接 提供 外 部 网 页 的 链接 。 如 果 想 记 录 每 个 网 页 的 访问 次 数 ， 这 样 做 不 太 合 适 。 为 
了 记录 Rango 应 用 中 各 网 页 的 访问 次 数 ， 要 这 人 么 做 : 


口 编写 一 个 视图 ， 命 名 为 track_urL()， 把 它 映 射 到 URL /rango/goto/ 上 ， 并 设 定 
‘name=goto' 人 参数。 


“J track_url() 视图 从 HTTP GET 请 求 参数 (例如 /rango/goto/?page_id=1) 中 获取 
page_id, 


。 在 视图 中 ， 通 过 page_id 获取 Page 对 象 ， 增 加 它 的 views 字段 ， 然 后 保存 。 
。 使 用 Django 的 redirect 函数 把 用 户 重 定向 到 真正 的 URL, 


。 如 果 HTTP GET 请 求 参 数 中 没有 page_id， 或 者 找 不 到 对 应 的 Page 对 象 ， 重 定向 到 首 
页 。 使 用 django.core.urlresolvers 模块 中 的 reverse KARA URL 字符 串 ， 然 后 重 
定向 。 如 果 使 用 的 是 Django 1.10， 可 以 从 django.shortcuts 模块 中 导入 reverse ph 
数 。 


。 redirect 和 reverse 的 更 多 信息 参见 Django 文档 。 


口 更 新 category.html 模板 ， 使 用 /rango/goto/?2page_id=XXX。 记 得 使 用 url 模板 标签 ， 不 要 硬 
编码 URL, 


<a href="{% url 'goto' %}?page_id={{page.id}}"> 


如 果 你 不 知道 如 何 从 HTTP GET 请 求 参数 中 获取 page_id 查询 字符 串 ， 请 参照 下 述 代 码 : 
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page_id = None 
if request.method == 'GET': 
if 'page_id' in request.GET: 
page_id = request.GET[ 'page_id'] 


一 定 要 先 检查 请 求 类 型 是 不 是 GET， 然 后 再 访问 request.GET 字典 ， 获 取 随 请 求 一 起 发 送 的 
Hao WRA pE page_id， 可 以 使 用 request.GET['page_id'] 获取 它 的 值 。 


此 外 也 可 以 不 使 用 查询 字符 串 ， 而 是 直接 放 在 URL 中 ， 例 如 /rango/goto/<page_id>/, XH} 
要 使 用 URL 模式 获取 page_id: r'goto/(?P<page_id>\d+)/$', 


14.2 在 分 类 页 面 中 搜索 


Rango 应 用 旨 在 为 用 户 提供 对 他 们 有 帮助 的 网 页 。 目 前 ， 搜 索 功 能 是 独立 于 分 类 单独 存在 的 。 如 
果 能 集成 到 分 类 页 面 中 的 话 更 好 。 我 们 假设 用 户 会 先 浏览 感 兴趣 的 分 类 ， 当 用 户 找 不 到 相关 网 页 
时 ， 就 可 以 搜索 。 如 果 用 户 找到 感 兴趣 的 网 页 ， 还 可 以 把 网 页 添加 到 分 类 中 。 现 在 我 们 先 集中 精 
力 解决 第 一 个 问题 ， 即 在 分 类 页 面 中 添加 搜索 功能 。 具 体 步骤 如 下 : 


J 把 导航 栏 中 的 搜索 链接 删除 ， 即 去 掉 独 立 的 搜索 功能 。 
J 把 search.himl 模板 中 的 搜索 表单 和 结果 展示 代码 移 到 category himl 模板 中 。 
口 修改 搜索 表单 ， 把 action 属性 的 值 改 为 当前 分 类 页 面 : 


<form class="form-inline" id="user_form" 


method="post" action="{% url 'show_category' category.slug %}"> 


口 更 新 show_category() 视图 ， 处 理 HTTP POST 请 求 。 还 要 把 搜索 结果 传 给 上 下 文字 典 ， 以 
便 在 模板 中 演 染 。 
J 此 外 ， 限 制 只 让 通过 身份 验证 的 用 户 搜 索 。 在 category.html 模板 中 要 这 样 限制 访问 : 


{% if user.authenticated %} 
<!-- 在 这 插入 搜索 代码 --> 
{% endif %} 


14.3 增加 个 人 资料 页 面 


如 果 你 换 用 django-registration-redux 包 了 ， 可 能 会 想 收集 用 户 的 个 人 资料 。 此 时 ， 不 能 把 用 户 重 
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定向 到 Rango 应 用 的 首页 ， 而 要 重 定向 到 一 个 新 的 表单 ， 让 用 户 提供 头像 和 个 人 网 站 。 基 本 步 又 
如 下 : 

口 8% profile_registration.himl 模板 ， 显 示 UserProfileForm, 

J X UserProfileFormModelForm 类 ， 处 理 这 个 新 表单 。 

1 编写 register_profile() 视图 ， 捕 获 用 户 提供 的 个 人 信息 。 

J 把 视图 映射 到 URL rango/register_profile/ 上 。 

m 


修改 MyRegistrationView 类 中 的 get_success_url() 方法 ， 把 重 定向 地 址 改 为 rango/ 
add_profile/ , 


此 外 ， 还 可 以 为 用 户 提供 查看 和 编辑 个 人 资料 的 功能 。 基 本 步骤 如 下 : 
口 创建 profile.html 模板 ， 显 示 一 个 表单 ， 添 加 几 个 字段 ， 分 别 显示 用 户 的 个 人 资料 〈 用 户 
名 、 电 子 邮 件 地 址 、 网 站 和 头像 ) 。 

1 编写 profile() 视图 ， 获 取 演 染 模板 所 需 的 数据 。 

中 把 profile() 视图 映射 到 URL /rango/profile/ E, 


J 修改 基 模 板 ， 在 导航 栏 中 添加 “Profile” 链 接 ， 最 好 与 其 他 用 户 相关 的 链接 放 在 一 起 。 这 个 
链接 只 有 已 登录 的 用 户 才能 看 到 ({% if user.is_authenticated %}) 。 


为 了 让 用 户 查 看 其 他 用 户 的 个 人 资料 ， 可 以 创建 一 个 用 户 列表 页 面 ， 列 出 全 部 用 户 。 点 击 某 个 用 
户 后 便 可 查看 他 的 个 人 资料 。 不 过 ， 必 须 确保 用 户 只 能 修改 自己 的 个 人 资料 。 


* 在 模板 中 引用 上 传 的 内 容 x 


43 节 讲 过 如 何 处 理 上 传 的 媒体 文件 ， 在 模板 中 可 以 使 用 {{ MEDIA_URL J) 标签 引用 


MEDIA_URL 地 址 (在 settings py 模块 中 设 定 ) ,例如 <img src="{{ MEDIA_URL}}cat.jpg">。 


附录 B 将 给 出 一 些 提示 ， 指 导 你 完成 上 述 功 能 。 
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jQuery 和 Django 


jQuery 是 个 优秀 的 JavaScript 库 ， 免 除了 很 多 痛苦 。 几 行 jQuery 代码 往往 能 封装 几 百 行 纯 
JavaScript 代码 。 而 且 ，jQuery 提供 了 一 整套 处 理 HTML 元 素 的 功能 。 本 章 将 讨论 : 


1 如 何在 Django 应 用 中 使 用 jQuery ; 
A 如 何 理解 jQuery 代码 ， 


J 提供 一 些 简 单 的 示例 。 


15.1 在 Django 项目/ 应 用 中 使 用 jQuery 


在 基 模 板 中 添加 下 述 代码 : 


{% load staticfiles %} 
<script src="https://cdn.staticfile.org/jquery/3.0.0/jquery.min.js"> 
<script src="{% static "js/rango-jquery.js" %}"></script> 


如 有 果 你 自己 下 载 了 jQuery， 保存 在 静态 文件 目录 中 ， 那 就 添加 下 述 代码 : 


<script src="{% static "js/jquery.min.js" %}"></script> 
<script src="{% static "js/rango-jquery.js" %}"></script> 


确保 你 设 定 了 静态 文件 相关 的 设置 (参见 第 4 章 ) 。 


在 static 目录 中 新 建 js 目录， 把 你 下 载 的 jQuery 脚本 文件 WUauery.aizjs) 保存 在 这 里 。 另 外 ,在 
这 个 目录 中 新 建 一 个 文件 ， 命 名 为 rango-jquery:js。 我 们 自己 编写 的 JavaScript 代码 保存 在 这 个 文 
件 中 。 打 开 rango-jquery js, A Fuk JavaScript 代码 : 


$(document).ready(function() { 
// jQuery 代码 写 在 这 里 
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ps 


这 段 代 码 使 用 jQuery 选择 文档 对 象 ($(document)) ， 然 后 调用 ready() 函数 。 浏 览 器 准备 好 文档 
之 后 (页面 完全 加 载 了 ) ， 执 行 function() { } 表示 的 匿名 函数 。 通 常 都 会 等 到 文档 加 载 完 毕 才 
执行 jQuery 函数 。 和 否则， 执行 代码 之 前 ， 相 应 的 HTML 元 素 可 能 尚未 加 载 。 详 情 参 见 jQuery X 
档 。 


文选 择 后 执行 "模式 * 


jQuery 代码 更 偏向 函数 式 编程 风格 ， 而 纯 JavaScript 代码 通常 采用 过 程式 编程 风格 。jQuery 
代码 遵循 的 模式 是 “选择 后 执行 ”: 先 选 择 一 个 元 素 ， 然 后 对 其 执行 某 种 操作 。 


示例 ， 点 击 后 弹出 对 话 框 


下 面 举 个 例子 ， 使 用 标准 的 JavaScript 和 jQuery 分 别 实现 相同 的 功能 ， 让 你 一 舌 二 者 之 间 的 差 
异 。 在 about.html 模板 中 添加 下 述 代 码 : 


<button class="btn btn-primary" 
onClick="alert('You clicked the button using JavaScript.');"> 
Click Me - I run JavaScript 

</button> 


可 以 看 到 ， 我 们 把 alert() 函数 赋值 给 按钮 的 onClick 属性 。 访 问 关 于 页 面 ， 试 试 效果 。 
下 面 使 用 jQuery 实现 同样 的 功能 。 在 about. Atm 模板 中 再 添加 一 个 按钮 : 


<button class="btn btn-primary" id="about-btn"> 
Click Me - I'm JavaScript on Speed</button> 


注意 ， 现 在 按钮 上 没有 任何 JavaScript 代码 。 相 应 的 代码 写 在 rango-jquery js 文件 中 : 


$(document).ready( function() { 
S$("#about-btn").click( function(event) { 
alert("You clicked the button using jQuery!"); 
H); 
p; 


刷新 页 面 ， 看 看 效果 。 理 论 上 点 击 两 个 按钮 后 都 会 弹出 对 话 框 。 


= 


IES jQuery 代码 先 选择 文档 对 象 ， 在 文档 准备 好 之 后 执行 其 中 的 函数 ， 即 
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$("#about-btn").click()。 这 部 分 代码 从 页 面 中 选择 id 为 about-btn 的 元 素 ， 然 后 以 编程 的 方式 
把 alert() 函数 赋予 click 事件 。 


一 开始 你 可 能 会 觉得 jQuery 有 些 麻烦 ， 毕 况 做 到 同一 件 事 ， 编 写 的 jQuery 代码 多 很 多 。 对 
alert() 这 样 的 简单 函数 来 说 ， 确 实 如 此 。 但 是 实现 复杂 的 功能 时 ， 使 用 jQuery 更 方便 ， 因 为 
JavaScript 代码 在 单独 的 文件 中 。jQuery 在 运行 时 赋予 事件 句柄 ， 实 现 了 关注 点 分 离 ， 即 把 
jQuery/JavaScript 代码 与 HTML 标记 解 耦 了 。 


国 分 开 是 好 事 Oo 


关注 点 分 离 是 一 种 值得 铭记 的 设计 原则 。 对 Web 应 用 来 说 ，HTML 负责 编写 页 面 的 内 容 ， 


CSS 用 于 装饰 内 容 的 外 观 ， 而 JavaScript 负责 与 内 容 交 互 ， 以 及 操纵 内 容 和 样式 。 


各 司 其 职 ， 这 样 写 出 的 代码 更 简洁 ， 能 减少 后 期 维护 的 投入 。 


选择 符 


jQuery 提供 了 多 种 选择 元 素 的 方式 。 前 例 展示 了 如 何 使 用 # 选择 符 在 HTML 文档 中 查找 特定 ID 
的 元 素 。 如 果 想 查找 类 ， 使用. 选择 符 ， 例 如 : 


$(".ouch").click( function(event) { 
alert("You clicked me! ouch!"); 


p; 


此 时 ， 文 档 中 class 属性 为 "ouch" 的 所 有 元 素 都 被 选中 ， 把 点 击 句 柄 设 为 alert() 函数 。 注 意 ， 
所 有 被 选中 的 元 素 都 被 赋予 了 同一 个 函数 。 


此 外 ， 还 可 以 通过 标签 名 选择 HTML 元 素 : 


S("p").hover( function() { 
S(this).css('color', 'red'); 
hs 
function() { 
S(this).css('color', 'blue'); 
H; 


把 这 段 JavaScript 代码 添加 到 rango-jquery js 文件 中 ， 然 后 在 about.html 模板 中 添加 一 个 段落 ， 
<p>This text is for a JQuery ExampLe</p>。 刷 新 关于 页 面 ， 把 鼠标 悬 停 在 那个 段落 上 看 看 效 
R, 
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这 里 ， 我 们 选择 所 有 HTML p 元 素 ， 并 为 悬 停 事件 关联 了 两 个 函数 ， 一 个 在 鼠标 移 到 元 素 上 时 执 
行 ， 另 一 个 在 鼠标 从 元 素 上 移 开 时 执行 。 可 以 看 到 ， 这 里 用 到 了 另 一 个 选择 符 ， 即 this。 这 个 选 
择 符 表 示 当 前 选中 的 元 素 。 注 意 ，jQuery 的 hover() 函数 接受 两 个 函数 。 


上 述 代码 要 添加 到 $(document) .ready() 函数 中 。 如 果 把 $(this) 改 成 $(p)， 情 况 如 何 ? 
助 停 是 一 种 鼠标 移动 事件 。 其 他 鼠标 移动 事件 的 说 明 参 见 jQuery API 文档 。 


15.2 示例 ， 操纵 DOM 


在 前 例 中 ， 我 们 使 用 hover() 函数 为 悬 停 事件 指定 处 理 句 柄 ， 然 后 使 用 css() 函数 修改 元 素 的 颜 
色 。css() 函数 用 于 操纵 DOM， 除 此 之 外 jQuery 库 提供 了 很 多 这 样 的 函数 。 例 如 ， 可 以 使 用 
addClass() 函数 为 元 素 添加 类 : 


$("#about-btn").addClass('btn btn-primary'); 
这 行 代码 选择 ID 为 about-btn 的 元 素 ， 为 其 添加 btn 和 btn-primary 两 个 类 。 
还 可 以 访问 某 个 元 素 内 部 的 HIML。 把 下 述 div 元 素 添 加 到 about.heml 模板 中 : 
<div id="msg">Hello - I'm here for a JQuery Example too</div> 
然后 在 rango-jquery js 中 添加 下 述 JavaScript 代码 : 


S("#about-btn").click( function(event) { 
msgstr = $("#msg").html() 
msgstr = msgstr + "ooo" 
S("#msg"). html (msgstr) 

H; 


点 击 ID 为 about-btn 的 元 素 后 ， 先 获取 ID 为 msg 的 元 素 中 的 内 容 ， 在 后 面 追加 "ooo" 之 后 ， 再 
次 调用 html() 函数 ， 传 人 修改 后 的 内 容 ， 蔡 换 元 素 中 现 有 的 HTML, 


本 章 简单 介绍 了 如 何在 Django 应 用 中 使 用 jQuery ， 还 举例 说 明了 jQuery 的 用 法 。 下 一 章 将 使 用 
jQuery 为 Rango 应 用 添加 Ajax 功能 。 
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使 用 jQuery 处 理 Ajax 请 求 


Ajax 是 一 项 综合 技术 ， 旨 在 减少 页 面 加 载 次 数 。 使 用 Ajax， 重 新 加 载 的 不 是 整个 页 面 ， 而 是 页 面 
中 的 部 分 内 容 或 数据 。 如 果 你 没 用 过 Ajax， 或 者 想 在 使 用 之 前 进一步 了 解 ， 请 阅读 Mozilla 网 站 
中 的 资料 。 


为 了 简化 处 理 Ajax 请 求 的 过 程 ， 我 们 将 使 用 jQuery 库 。 注 意 ， 如 果 你 使 用 了 Twitter Bootstrap, 
那 束 已 经 添加 了 jQuery。 我 们 使 用 的 是 jQuery 3。 如 果 不 想 引 用 在 线 版 ， 可 以 把 jQuery 库 下 载 到 
本 地 ， 保 存在 项 目的 static/js/ 目录 中 。 


16.1 通过 Ajax 实现 的 功能 
为 了 提升 Rango 应 用 的 现代 感 ， 我 们 将 使 用 Ajax 实现 一 些 功能 ,例如 : 


J 添加 “Like” 按 钮 ， 让 注册 用 户 为 分 类 点 赞 。 
J 添加 行内 分 类 建议 ， 让 用 户 在 输入 的 过 程 中 快速 找到 某 个 分 类 。 
J 在 搜索 结果 中 话 加 “Add 按钮， 方便 注册 用 户 把 网 页 添加 到 分 类 中 。 


在 staticljs/ 目录 中 新 建 一 个 文件 ， 命 名 为 rango-ajax.js。 在 基 模 板 中 添加 下 述 内 容 : 


<script src="{% static "js/jquery.min.js" %}"></script> 
<script src="{% static "js/rango-ajax.js" %}"></script> 


这 里 ， 我 们 假设 你 把 jQuery 库 下 载 到 本 地 了 。 此 外 还 可 以 直接 引用 线 上 版 本 : 


<script 
src="https://cdn.staticfile.org/jquery/3.0.0/jquery.min.js"> 
</script> 


如 果 你 使 用 Bootstrap ， 滚 动 到 模板 文件 的 底部 ， 你 会 看 到 引用 jQuery 库 的 代码 。 在 jQuery 库 之 
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后 引入 rango-ajax.js 文件 。 


至 此 ， 我 们 引入 了 jQuery， 也 有 位 置 编写 客户 端 Ajax 代码 了 。 下 面 开始 修改 Rango 应 用 。 


16.2 添加 点 赞 按钮 


允许 注册 用 户 表示 他 们 “喜欢 ” 某 个 分 类 是 个 不 错 的 功能 。 我 们 将 实现 为 分 类 “点 赞 ” 的 功能 ， 但 不 
记录 用 户 为 哪些 分 类 点 了 赞 。 注 册 用 户 可 以 不 断 刷 新 页 面 ， 多 次 点 击 点 赞 按钮 。 如 果 想 记录 用 户 
点 赞 了 哪些 分 类 ， 要 再 定义 一 个 模型 ， 还 需要 其 他 辅助 设置 。 这 留 作 练 习 给 你 完成 。 


基本 流程 
让 用 户 为 分 类 点 赞 的 基本 过 程 如 下 


口 打开 category.himl 模板 ， 添 加 “Like” 按 钮 ， 把 I 有 D 设 为 Like;， 添加 一 个 模板 标签 ， 显示 点 赞 
次 数 ，{{% category.likes %}}; 把 点 赞 次 数 放 在 ID 为 Like_count 的 div 元素 中 : <div 
id="like_count">{{ category.likes }}</div>, category() 视图 传人 了 分 类 对 象 ， 因 此 在 
模板 中 可 以 通过 {{ category.likes }} 访问 点 赞 次 数 。 

1 编写 一 个 视图 ， 命 名 为 Like_category()， 从 请 求 中 获取 category_id 参数 ， 增 加 对 应 分 类 
的 点 击 次 数 。 这 个 视图 不 返回 HTML 页 面 ， 而 是 返回 对 应 分 类 的 点 赞 次 数 。 

J 把 tike_category() 视图 映射 到 一 个 URL 上 ,例如 rango/like/。 那 么 GET 查询 参数 为 ran- 
gollike/?category_id=XXX, 


“1 Æ rango-ajaxjs 文件 中 编写 jQuery 代码 ， 执 行 Ajax GET 请 求 。 如 果 请 求 成 功 ， 更 新 
#like_count 元 素 ， 并 隐藏 点 赞 按钮 。 


修改 分 类 页 面 的 模板 


我 们 要 在 模板 中 添加 “Like”" 按 钮 ， 并 把 按钮 的 ID 设 为 Litke。 些 外， 还 要 添加 一 个 <div> 元 素 ， 显 
示 点 赞 次 数 。 打 开 category htm 模板 文件 ， 在 <h1>{{ category.name }}</h1> 下 方 添加 下 述 代 
码 : 


<div> 
<strong id="like count">{{ category.likes }}</strong> people like this category 
{% if user.is_authenticated %} 
<button id="Likes" data-catid="{{category.id}}" 
class="btn btn-primary btn-sm" type="button"> 
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Like 
</button> 
{% endif %} 


</div> 


编写 视图 


在 rango/views py 模块 中 编写 一 个 新 视图 ， 命 名 为 Like_category()。 这 个 视图 从 请 求 中 获取 
category_id 参数 ， 然 后 增加 对 应 分 类 的 点 赞 次 数 。 


from django.contrib.auth.decorators import login required 


@login required 
def Like_category(request): 
cat_id = None 


if request.method == 'GET': 

cat_id = request.GET['category_id'] 
likes = 0 

if cat_id: 


cat = Category.objects.get(id=int(cat_id)) 
if cat: 
likes = cat.likes + 1 
cat.likes = likes 
cat.save() 
return HttpResponse(likes) 


可 以 看 到 ， 我 们 只 人 允许 通过 身份 验证 的 用 户 访问 这 个 视图 ， 因 为 视图 上 面 有 @login_required $ 
人 饰 器 。 


注意 ， 这 个 视图 假定 GET 请 求 参数 中 有 category_id 变量 ， 以 此 标识 要 更 新 的 分 类 。 这 里 还 可 以 
记录 是 哪个 用 户 点 的 赞 ， 不 过 为 了 集中 精力 讲解 Ajax， 一 切 从 简 。 


别 忘 了 在 rangolurls py 模块 中 添加 URL 映射 。 在 urlpatterns 列表 中 添加 : 


url(r'^like/$', views.like category, name='like category'), 


发 起 Ajax 请 求 


现在 要 在 rango-ajax,js 文件 中 添加 一 些 jQuery 代码 ， 执 行 Ajax GET 请 求 。 
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S('#likes').click(function(){ 
var catid; 
catid = $(this).attr("data-catid"); 
$.get('/rango/like/', {category_id: catid}, function(data){ 
S('#Llike_count').html(data); 
S('#likes').hide(); 
H); 
H; 


X Ez jQuery/JavaScript 代码 为 #likes 元 素 添 加 一 个 事件 句柄 。 点 击 这 个 按钮 后 ， 从 按钮 元 素 中 提 
取 分 类 ID ， 然 后 向 /rangollike/ 发 起 Ajax GET 请 求 ， 并 在 请 求 中 编码 category id。 如 果 请 求 成 
功 ， 使 用 返回 的 数据 更 新 #like_count 元 素 的 内 容 ， 并 把 #likes 元 素 隐 藏 起 来 。 


这 里 涉及 很 多 知识 ， 而 且 Ajax 对 页 面 结构 有 一 定 的 要 求 ， 容 易 出 错 。 简 单 而 言 ， 点 击 按钮 后 ， 我 
们 通过 Ajax 请 求 一 个 URL, fh Like_category() 视图 更 新 分 类 ， 返 回 点 赞 次 数 。Ajax 请 求 收 
到 响应 后 ， 更 新 页 面 中 的 部 分 内 容 ， 即 点 赞 次 数 ， 并 把 likes 按钮 隐藏 起 来 。 


16.3 添加 行内 分 类 建议 


现在 ， 用 户 要 在 一 个 长 列表 里 寻找 自己 感 兴趣 的 分 类 ， 如 果 能 提供 一 种 快速 查找 分 类 的 方法 就 好 
了 。 为 此 ， 我 们 可 以 在 用 户 输入 的 过 程 中 向 服务 器 发 送 请 求 ， 获 取 一 些 分 类 建议 ， 让 用 户 选 择 。 


基本 流程 


实现 行内 分 类 建议 的 基本 步 又 如 下 : 


口 定义 一 个 带 参 数 的 函数 ， 命 名 为 get_category_list(max_results=0,starts_with=''), ù 
果 max_resuLts=0， 返 回 所 有 以 starts_with 开头 的 分 类 ; 和 否则， 最 多 返回 max_results 个 
分 类 。 

1 编写 一 个 视图 ， 命 名 为 suggest_category()， 通 过 查询 字符 串 获 取 分 类 。 


”假设 是 GET 请 求 ， 尝 试 访问 query 参数 。 

。 如 果 query 参数 不 为 空 ， 从 Category 模型 中 获取 以 此 开头 的 前 8 个 分 类 。 

。 通过 模板 显示 分 类 列表 。 

。 不 要 新 建 模 板 了 ， 可 以 继续 使 用 cats.html， 毕 竟 显 示 的 是 同 种 数据 ( 即 分 类 ) 。 
。 为 了 让 客户 端 请 求 数据 ， 要 添加 一 个 URL 映射 ， 姑 且 称 之 为 suggest IE, 
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在 此 之 后 ， 要 更 新 base html 模板 ， 加 上 分 类 搜索 框 。 然 后 编写 一 些 JavaScript/jQuery 代码 ， 获 取 
分 类 列表 ， 在 用 户 输 入 的 过 程 中 显示 。 


打开 base. htm 模板 ， 修 改 侧 边栏 ， 添 加 一 个 <div> wR, ID 为 cats， 用 于 显示 建议 的 分 类 。 这 
个 元 素 的 内 容 由 jQuery/JavaScript 更 新 。 在 这 个 <div> 元 素 前 面 添加 一 个 搜索 框 ， 供 用 户 输入 想 
搜索 的 分 类 。 


<input class="input-medium search-query" type="text" 
name="Suggestion" value="" id="sSuggestion" /> 


在 模板 中 添加 这 些 元 素 之 后 ， 编 写 jQuery 代码 ， 在 用 户 输入 的 过 程 中 更 新 分 类 列表 。 


为 #suggestion 输入 框 注册 一 个 按键 事件 句柄 : $('#suggestion' ) .keyup(function(){  })。 在 键 
盘 回升 时 通过 .get() 函数 发 起 一 个 Ajax HK ($(this).get(..)) ， 获 取 更 新 的 分 类 列表 。 如 果 请 
求 成 功 ， 使 用 .htmL() 函数 ， 把 #cats 元 素 的 内 容 蔡 换 掉 ($('#cats').html(data)) 。 


</> 练习 


修改 填充 脚本 添加 这 几 个 分 类 : Pascal, Perl, PHP, Prolog, PostScript 和 Programming。 这 
样 更 能 看 出 分 类 建议 功能 的 作用 。 


定义 辅助 函数 


我 们 可 以 定义 一 个 辅助 方法 ， 使 用 过 滤器 查找 以 指定 字符 串 开 头 的 分 类 。 我 们 要 使 用 的 过 滤器 是 
istartwith， 即 不 区 分 字母 的 大 小 写 。 如 果 想 区 分 大 小 写 ， 使 用 startswith, 


def get_category_list(max_results=0, starts_with=''): 
cat_list = [] 
if starts_with: 
cat_list = Category.objects.filter(name__istartswith=starts_with) 


if max_results > 0: 
if len(cat_list) > max_results: 
cat_list = cat_list[:max_results ] 
return cat_list 
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编写 视图 
编写 一 个 视图 ， 调 用 get_category_list() 函数 ， 获 取 匹 配 条 件 的 前 8 个 分 类 。 


def suggest_category(request): 
cat_list = [] 
starts_with = '' 

if request.method == 'GET': 
starts_with = request.GET[ ‘suggestion’ ] 

cat_list = get_category_list(8, starts_with) 


return render(request, 'rango/cats.html', {'cats': cat_list }) 


注意 ， 这 个 视图 重用 了 rango/cats htm 模板 。 


映射 URL 


打开 rango/urls py 模块 ， 把 下 述 代码 添加 到 urlpatterns 列表 中 : 


url(r'4suggest/$', views.suggest_category, name='suggest_category'), 


更 新 基 模 板 


在 基 模 板 的 侧 边栏 中 添加 下 述 HTML 标记 : 


<ul class="nav nav-list flex-column"> 
<li class="nav-item">Type to find a category</li> 
<form> 
<li class="nav-item"><input class="Search-query form-control" type="text" 
Name="sSuggestion" vaLlue="" id="Suggestion" /> 
</li> 
</form> 
</ul> 
<hr> 
<div id="cats"> 


</div> 


我 们 添加 了 一 个 卫 为 suggestion 的 输入 框 ， 以 及 一 个 了 为 cats 的 <div> 元 素 ， 用 于 显示 分 类 
建议 。 这 里 无 需 添加 按钮 ， 因 为 我 们 将 为 输入 框 的 按键 事件 注册 一 个 事件 句柄 ， 通 过 Ajax 获取 分 
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类 建议 。 
把 模板 中 的 下 面 三 行 代码 删除 : 


{% block sidebar_block %} 
{% get_category_list category %} 
{% endblock %} 


通过 Ajax 请 求 获取 分 类 建议 
在 js/rango-ajax 六 文件 中 添加 下 述 jQuery 代码 : 


$('#suggestion').keyup(function(){ 
var query; 
query = $(this).val(); 
$.get('/rango/suggest/', {suggestion: query}, function(data){ 
S('#cats').html(data); 
H); 
H; 


我 们 为 ID X suggestion 的 输入 元 素 注 册 了 一 个 句柄 ， 在 按键 回升 事件 触发 时 执行 。 该 事件 触发 
时 ， 把 输入 框 中 的 内 容 赋值 给 query 变量 ， 然 后 向 /rango/suggest/ 发 起 Ajax GET 请 求 。 如 果 请 求 
成 功 ， 更 新 ID A cats 的 元 素 ， 把 里 面 的 内 容 蔡 换 为 得 到 的 分 类 建议 。 


Type to find a Type to find a Type to find a 
category category category 
pl pl 
Pascal Programming 
Php Prolog 
Python 


Perl 
Programming 
Prolog 


图 16-1: 行内 分 类 建议 示例 。 注 意 建议 的 分 类 在 输入 的 过 程 中 是 有 变化 的 。 


</> 练习 


为 了 方便 注册 用 户 把 网 页 添加 到 分 类 中 ， 在 各 搜索 结果 旁 添 加 一 个 "Add- 按钮 。 
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1 更 新 category.himl 模板 ， 在 各 搜索 结果 旁 添 加 “Add 按钮 〈 仅 针对 通过 身份 验证 的 用 
户 ) 。 这 个 按钮 要 标 有 网 页 的 标题 和 URL， 供 jQuery 使 用 。 


了 把 分 类 页 面 中 的 网 页 列表 放 在 一 个 了 为 page 的 <div> 元 素 中 ， 以 便 添加 网 页 后 更 新 
其 中 的 内 容 。 

J 编写 一 个 视图 ， 例 如 名 为 auto_add_page()， 从 GET 请 求 参数 中 获取 title, url 和 
catid， 把 网 页 添加 到 相应 的 分 类 中 。 

J 把 这 个 视图 上 映射 到 一 个 URL E: url(r'*add/$', views.auto_add_page, 


name='auto_add_page'), 


了 使 用 jQuery 为 "Add 按钮 添加 一 个 事件 句柄 ， 添 加 网 页 后 隐藏 `" Add 按钮 。 


在 category html 模板 中 添加 的 代码 如 下 。 注 意 ， 这 个 按钮 要 标 有 一 些 重要 的 信息 。 


{% if user.is_authenticated %} 
<button data-catid="{{category.id}}" data-title="{{ result.title }}" 
data-url="{{ result.link }}" 
class="rango-add btn btn-info btn-sm" type="button">Add</button> 
{% endif %} 


然后 为 类 为 rango-add 的 每 个 按钮 添加 Click 事件 句柄 : 


$('.rango-add').click(function(){ 
var catid = $(this).attr("data-catid"); 
var url = $(this).attr("data-url"); 
var title = $(this).attr("data-title"); 
var me = $(this) 
$.get('/rango/add/', 
{category_id: catid, url: url, title: title}, function(data){ 
S('#pages').html(data); 
me. hide(); 
H; 
H); 


视图 代码 : 
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@login_required 
def auto_add_page(request): 


cat_id = None 


url = None 

title = None 

context_dict = {} 

if request.method == 'GET': 


cat_id = request.GET['category_id'] 

url = request.GET['url'] 

title = request.GET['title'] 

if cat id: 
category = Category.objects.get(id=int(cat_id)) 
p = Page.objects.get_or_create(category=category, 

title=title, url=url) 
pages = Page.objects.filter(category=category).order_by('-views') 
# 把 网 页 列表 传 给 模板 上 下 文 
context_dict['pages'] = pages 
return render(request, 'rango/page_list.html', context_dict) 


新 模板 page_list.html 的 内 容 : 


{% if pages %} 
<ul> 
{% for page in pages %} 
<li><a href="{% url 'goto' %}?page_id={{page.id}}"\>{{ page.title }}</a></li> 
{% endfor %} 
</ul> 
{% else %} 
<strong>No pages currently in category.</strong> 
{% endif %} 


\D AN DUN KRW NB 


最 后 ， 别 忘 了 添加 URL 映射 : 
url(r'4add/$', views.auto_add_page, name='auto_add_page'), 


如 果 一 切 顺 利 ， 分 类 页 面 中 的 搜索 结果 如 图 16-2 所 示 。 
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© © @ / B® Rango - How to Tango with Di x David 


€ CŒ | ® 127.0.0.1:8000/rango/category/python/ wongo 


Rango 
Type to find a python for loop 
category 


Results 
ForLoop - Python Wiki 


For loops. Usage in Python. When do I use for loops? For loops are traditionally used when you have a 
piece of code which you want to repeat n number of times. 


4. More Control Flow Tools — Python 2.7.12 documentation 


4. More Control Flow Tools] Besides the while statement just introduced, Python knows the usual control 
flow statements known from other languages, with some twists. 


Python Programming/Loops - Wikibooks, open books for an... 
Python Programming/Loops. From Wikibooks, open books for an open world ... The next type of loop in 
Python is the for loop. Unlike in most languages, ... 


Python Loops - Tutorialspoint - Tutorials for Kanban... 


Python Loops - Learning Python in simple and easy steps : A beginner's tutorial containing complete 
knowledge of Python Syntax Object Oriented Language, Methods ... 


图 16-2: PRA MPRA REY “Add Hef 
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目 动 化 测试 


编写 测试 是 个 好 习惯 ， 这 样 能 确保 软件 稳固 可 靠 。 当 然 ， 有 时 大 部 分 时 间 都 用 在 实现 功能 上 ， 没 
有 多 少时 间 过 问 软 件 运行 得 如 何 ， 或 者 过 于 自 大 ， 确 信 自 己 写 出 的 功能 一 定 能 用 。 


编写 测试 的 原因 有 很 多 ，Dijango 官方 教程 列 出 了 几 点 : 


2 测试 能 节省 时 间 : 修改 复杂 的 系统 时 可 能 会 出 现 意 外 失误 。 
a 测试 不 仅 能 找 出 问题 ， 还 能 避免 问题 的 发 生 : 测试 能 指出 哪些 代码 不 符合 预期 。 


J 测试 能 让 代码 更 具 魅 力 : Django 的 原始 开发 者 之 一 Jacob Kaplan-Moss 说 过 ,“ 没 有 测试 的 
代码 先天 不 足 ”。 


2 测试 能 协助 团队 协作 ， 防 止 困 队 中 的 成 员 不 小 心 破坏 功能 。 


根据 Python 指南 ， 编 写 测试 时 要 遵守 一 些 基本 规则 。 下 面 是 其 中 几 条 重要 的 规则 


测试 应 该 针对 具体 的 小 功能 
测试 应 该 有 明确 的 目的 

测试 应 该 独立 

在 编写 代码 之 前 ， 提 交 和 推送 代码 之 前 要 运行 测试 
最 好 创建 一 个 钧 子 ， 在 推送 代码 时 运行 测试 
测试 的 名 字 不 怕 长 ， 要 明确 表明 意图 


HO U O G O 


* 说 明太 


目前 本 章 的 内 容 还 很 基础 ， 而 且 与 Django 官方 教程 中 的 内 容 差 不 多 ， 不 过 增加 了 一 些 说 


明 。 笔 者 计划 以 后 再 扩充 本 章 的 内 容 。 
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— j am + + 
17.1 运行 测试 
Django 集成 了 测试 功能 。 可 以 执行 下 述 命令 测试 Rango 应 用 : 
$ python manage.py test rango 


Creating test database for alias 'default'... 


Ran 0 tests in 0.000s 


OK 
Destroying test database for alias 'default'... 


这 个 命令 运行 Rango 应 用 中 的 所 有 测试 。 目 前 ， 我 们 的 应 用 还 没什么 测试 。 不 信 打 开 rango/ 
tests py 文件 看 看 ， 里 面 只 有 一 个 导入 语句 。 每 次 创建 应 用 ，Django 都 会 自动 生成 这 样 一 个 文件 ， 
鼓励 你 编写 测试 。 


从 输出 中 可 以 看 到 ， 提 到 了 一 个 名 为 "default 的 数据 库 。 运 行 测试 时 ，Django 会 创建 一 个 临时 数 
据 库 ， 供 测试 填充 数据 和 执行 操作 。 这 样 ， 测 试 时 使 用 的 数据 库 就 与 线 上 数据 库 隔离 开 了 。 


17.2 测试 模型 


下 面 我 们 来 编写 一 个 测试 。 对 Category 模型 的 各 属性 来 说 ， 我 们 希望 查看 次 数 的 值 为 零 或 正 数 ， 
难道 次 数 能 小 于 零 ? 为 了 测试 这 个 限制 ， 把 下 述 代 码 写 人 rango/tests py 文件 : 


from django.test import TestCase 
from rango.models import Category 


class CategoryMethodTests(TestCase): 
def test_ensure_views_are_positive(self): 


ensure_views_are_positive 函数 在 分 类 的 查看 次 数 
为 零 或 正 数 时 应 该 返回 True 

cat = Category(name='test',views=-1, likes=0) 
cat.save() 

self.assertEqual((cat.views >= 0), True) 
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如 果 你 以 前 没 写 过 测试 ， 首 先 注意 ， 测 试 继承 自 Testcase 类 。 其 中 的 方法 也 有 约定 ， 名 称 以 
test_ 开头 的 方法 都 是 测试 用 例 ， 里 面 有 一 些 断 言 (assertion) 。 这 里 ， 我 们 使 用 assertEqual() 
方法 判断 两 个 值 是 否 相 等 。 此 外 还 有 很 多 断言 方法 可 用 (例如 assertItemsEqual, 
assertListEqual、assertDictEqual， 等 等 ) ,详情 参见 文档 (Python 2 版 ，Python 3 版 ) o Djan- 
go 的 测试 机 制 源 自 Python， 在 此 基础 上 还 额外 提供 了 一 些 断 言 方法 。 


下 面 运行 测试 : 
$ python manage.py test rango 


Creating test database for alias 'default'... 


Traceback (most recent call last): 
File "/Users/leif/Code/tango_with_django_project_19/rango/tests.py", 
line 12, in test ensure views are positive 
self.assertEqual((cat.views>=0), True) 
AssertionError: False != True 


Ran 1 test in 0.001s 


FAILED (failures=1) 


可 以 看 到 ， 这 个 测试 失败 了 。 这 是 因为 Category 模型 并 没有 检查 查看 次 数 的 值 是 否 小 于 零 。 我 们 
确实 想 保 证 这 个 属性 的 值 不 为 负数 ， 因 此 要 修改 模型 ， 加 入 这 一 限制 。 请 在 Category 模型 的 
save() 方法 中 添加 一 些 代 码 ， 检 查 views 属性 的 值 。 这 里 只 需 检查 seLf .views 的 值 是 否 小 于 零 就 
足够 了 。 


修改 模型 之 后 再 运行 测试 ， 看 看 能 不 能 通过 。 如 果 不 能 ， 再 修改 。 
下 面 再 编写 一 个 测试 ， 确 保 别 名 的 格式 正确 ， 即 以 连 字符 连接 各 词 ， 而 且 全 为 小 写字 母 。 把 下 述 
代码 添加 到 rango/tests. py 文件 中 : 


def test_slug_line_creation(self): 


Slug_line_creation 确保 添加 分 类 时 创建 的 别名 格式 是 正确 的 
例如 "Random Category String" -> "random-category-string" 
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cat = cat('Random Category String') 
cat.save() 
self.assertEqual(cat.slug, 'random-category-string') 


现在 的 代码 能 让 这 个 测试 通过 吗 ? 


17.3 测试 视图 


前 一 节 编 写 的 测试 用 于 确保 模型 中 数据 的 完整 性 。Django 还 为 视图 提供 了 测试 机 制 ， 使 用 一 个 模 
拟 客 户 端 通过 URL 访问 Django 视图 。 在 视图 测试 中 可 以 访问 响应 (包括 HTML) 和 上 下 文字 
典 


一 oo 


下 面 编写 一 个 测试 ， 确 认 Category 模型 为 空 时 ， 首 页 会 显示 “There are no categories present” 消 


/Co 


from django.core.urlresolvers import reverse 


class IndexViewTests(TestCase): 


def test_index_view_with_no_categories(self): 


如 果 没 有 分 类 ， 应 该 显示 一 条 提示 消息 

response = self.client.get(reverse('index')) 
self.assertEqual(response.status code, 200) 
self.assertContains(response, "There are no categories present.") 
self.assertQuerysetEqual(response.context[ 'categories'], []) 


Hc, Django TestCase 能 访问 client 对 象 ， 请 求 就 是 通过 它 发 送 的 。 这 个 测试 使 用 reverse 函数 
查询 首页 的 URL， 然 后 访问 那个 页 面 ， 得 到 response 对 象 。 这 个 测试 检查 了 几 件 事 : 首页 能 不 
能 成 功 加 载 ， 啊 应 HTML 中 是 否 包 含 “There are no categories present.” 这 句 话 ， 以 及 上 下 文字 典 中 
的 分 类 列表 是 否 为 空 。 别 忘 了 ， 运 行 测试 时 会 创建 一 个 新 数据 库 ， 但 是 默认 没有 填充 任何 数据 。 


下 面 添 加 几 个 分 类 ， 然 后 再 测试 视图 。 首 先 定义 一 个 辅助 方法 : 
from rango.models import Category 


def add_cat(name, views, likes): 
c = Category.objects.get_or_create(name=name) [0] 
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c.views = views 
c.likes = likes 
c.save() 
return c 


然后 在 IndexViewTests 类 中 再 添加 一 个 测试 方法 : 


def test index view with categories(self): 


确保 首页 显示 了 分 类 


add_cat('test',1,1) 
add_cat('temp',1,1) 
add_cat('tmp',1,1) 
add_cat('tmp test temp',1,1) 


response = self.client.get(reverse('index')) 
self.assertEqual(response.status_ code, 200) 
self.assertContains(response, "tmp test temp") 


num_cats =Len(response.context[ 'categories']) 
self.assertEqual(num_cats , 4) 


这 个 测试 先 向 数据 库 中 填充 4 个 分 类 ， 然 后 检查 页 面 中 有 没有 “tmp test temp" 文 本 ， 以 及 分 类 数量 
是 不 是 4 个 。 注 意 ， 这 里 做 了 三 项 检查 ， 但 是 同属 一 个 测试 。 


17.4 测试 演 染 的 页 面 

使 用 Django 的 测试 客户 端 和 (或) Selenium 还 可 以 启动 应 用 ， 以 编程 的 方式 测试 HTML 页 面 中 
的 DOM 元 素 。 这 里 不 再 举例 说 明 。 

17.5 测试 覆盖 度 


履 盖 度 衡量 有 多 少 代码 已 被 测试 ， 还 有 多 少 尚未 得 到 测试 。 可 以 安装 coverage 包 (pip install 
coverage) ， 让 它 为 我 们 统计 履 盖 度 。 安 装 好 之 后 ， 执 行 下 述 命令 : 


$ coverage run --source='.' manage.py test rango 
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这 个 命令 检查 Rango MAMA Min, (ome. Aa ae, MITRENA: 


$ coverage report 


Name Stmts Miss Cover 
manage 6 0 100% 
populate 33 33 0% 
rango/__init__ 0 0 100% 
rango/admin 7 0 100% 
rango/forms 35 35 0% 
rango/migrations/0001_initial 5 0 100% 
rango/migrations/0002_auto_20141015 1024 5 0 100% 
rango/migrations/0003 category_slug 5 0 100% 
rango/migrations/0004_auto_20141015 1046 5 0 100% 
rango/migrations/0005_userprofile 6 0 100% 
rango/migrations/ _init__ 0 0 100% 
rango/models 28 3 89% 
rango/tests 12 0 100% 
rango/urls 12 12 0% 
rango/views 110 110 0% 
tango _ with django project/_ init _ 0 0 100% 
tango_with_django_project/settings 28 0 100% 
tango_with_django_project/urls 9 9 0% 
tango_with_django_project/wsgi 4 4 0% 
TOTAL 310 206 34% 


从 上 述 报告 可 以 看 出 ， 很 多 重要 的 代码 还 没有 测试 ， 例 如 rango/views 中 的 视图 。coverage 包 功 能 
丰 语 ， 能 协助 你 编写 更 全 面 的 测试 。 


</> 练习 


假设 我 们 想 扩展 Page 模型 ， 添 加 两 个 字段 : Last_visit 和 first_visit。 这 两 个 字段 的 类 型 


都 是 timedate。 


1 更 新 Page 模型 ， 添 加 这 两 个 字段 。 
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1. Test-Driven Development with Python》 一 书 的 中 文 版 由 本 书 译 者 翻译 ， 由 人 民 邮 电 出 版 社 出 版 。 
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部 署 Django m H 


本 章 带 领 你 一 步 一 步 部 署 Django 应 用 。 我 们 将 把 应 用 部 署 到 PythonAnywhere 上 ， 这 是 一 个 在 线 
IDE 和 托管 服务 ， 在 浏览 器 中 就 能 访问 服务 器 端的 Python 和 Bash 命令 行 界面 。 因 此 ， 在 你 的 电 
脑 中 就 能 通过 终端 操作 PythonAnywhere 的 服务 器 。PythonAnywhere 的 免费 账户 提供 了 一 定量 的 
存储 空间 和 CPU 时 间 ， 足 够 运行 Django 应 用 。 


18.1 注册 PythonAnywhere 账户 


首先 ， 注 册 一 个 PythonAnywhere 入 门 账户 。 如 果 你 的 应 用 发 展 形式 好 ， 深 受 欢 迎 ， 随 时 可 以 升级 
套餐 ， 获 得 更 多 的 存储 空间 和 CPU 时 间 ， 以 及 其 他 好 处 ,例如 自 定义 域名 和 SSH, 


注册 账户 后 ，PythonAnywhere 会 为 你 分 配 一 个 网 址 ， 格 式 为 http://<username> pythonany- 
where.com， 其 中 <username> 是 你 的 PythonAnywhere 用 户 名 。 你 的 应 用 就 通过 这 个 URL 访问 。 


18.2 PythonAnywhere 的 Web 界面 


PythonAnywhere 的 Web 界面 有 个 控制 面板 ， 用 于 管理 你 的 应 用 ， 如 图 18-1 所 示 。 


1 Consoles 组 件 : 创建 并 与 Python 和 Bash 控制 台 交 互 。 
J Files 组 件 : 上 传 和 管理 文件 。 
1 Web Apps 组 件 : 配置 托管 的 Web 应 用 。 


此 外 还 有 Notebooks 等 组 件 ， 但 是 我 们 现在 用 不 到 。 本 章 主要 使 用 Consoles 和 Web Apps 组 件 。 
如 果 想 了 解 其 他 组 件 的 用 法 ， 请 阅读 PythonAnywhere 维基 中 的 详细 说 明 。 
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| © © © /% Dashboard : rangodemo2018 x David 
() Dashboard : rangodemo: = 


ée Œ @ Secure | https://www.pythonanywhere.com/user/rangodemo2018/ r/G9H Geo: 


Send feedback Forums Help Blog Account Log out 


Ber pythonanywhere Dashboard Consoles Files Web Tasks Databases 
Dashboard Welcome back, rangodemo2018 
CPU Usage: 0% used - 0.00s of 100s. Resets in 23 hours, 59 minutes (ESTED Upgrade Account 
File storage: 0% full — 8.0 KB of your 512.0 MB quota 
Recent Recent Recent All 
Consoles Elsi] Files [lsl-] Notebooks [+lsi-] Web apps 
You have no recent consoles. You have no recently edited files. You don't have any web apps. 
Your account does not 
7 support Jupyter a ~ 

New console: + Open another file Notebooks. Upgrade your ( Open Web tab ) 

一 account to get access! ——= 

k 
4 N 
( More. -) 


图 18-1: PythonAnywhere 的 控制 面板 ， 显 示 着 可 用 的 主要 组 件 


18.3 搭建 虚拟 环境 


PythonAnywhere 的 默认 Bash 环境 自 带 Python 2.7.6 和 一 些 包 (包括 Django 1.3.7 和 Django-Regis- 
tration 0.8) 。 这 与 我 们 所 需 的 环境 不 同 ， 因 此 我 们 要 创建 一 个 虚拟 环境 。 


首先 ， 打 开 Bash 控制 台 。 在 PythonAnywhere 的 控制 面板 中 点 击 Consoles 组 件 下 方 的 “$ Bash’ Fz 
钮 。 此 时 会 出 现 一 个 黑色 界面 ， 初 始 化 终端 。 终 端 初始 化 完成 后 〈 看 到 时 间 ) ， 输 入 下 述 命令 ; 


S mkvirtualenv --python=<python-version> rango 


如 果 你 在 阅读 本 书 的 过 程 中 使 用 的 是 Python 3.x, 4E <python-version> 替换 为 python3.4、 
python3.5 BK python3.6 (在 你 的 电脑 中 执行 python --version 命令 ， 确 认 版 本 号 ) 。 如 果 你 使 用 
的 是 Python 2.7.x， 把 <python-version> 替换 为 python2.7。 上 述 命令 使 用 你 指定 的 Python 版 本 创 
建 一 个 虚拟 环境 ， 名 为 rango。 下 面 是 笔者 创建 Python 3.6 虚拟 环境 得 到 的 输出 : 


11:45 ~ $ mkvirtualenv --python=python3.6 rango 

Running virtualenv with interpreter /usr/bin/python3.6 

New python executable in /home/rangodemo2018/.virtualenvs/rango/bin/python3.6 
Also creating executable in /home/rangodemo2018/.virtualenvs/rango/bin/python 
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Installing setuptools, pip, wheel...done. 

virtualenvwrapper creating /home/rangodemo2018/.virtualenvs/.../predeactivate 
virtualenvwrapper creating /home/rangodemo2018/.virtualenvs/.../postdeactivate 
virtualenvwrapper creating /home/rangodemo2018/.virtualenvs/.../preactivate 
virtualenvwrapper creating /home/rangodemo2018/.virtualenvs/.../postactivate 
virtualenvwrapper creating /home/rangodemo2018/.virtualenvs/.../get_env_details 


注意 ， 这 段 输出 中 的 PythonAnywhere 用 户 名 是 rangodemo2018。 你 看 到 的 将 是 你 自己 的 用 户 名 。 
创建 虚拟 环境 要 花 一 点 时 间 ， 创 建 完毕 后 你 会 看 到 一 个 稍微 不 同 的 提示 符 : 


(rango) 11:45 ~ $ 


注意 ， 与 之 前 相 比 ， 现 在 多 了 (rango)。 这 表示 rango 虚拟 环境 已 激活 ， 所 有 包 都 将 安装 在 这 个 虚 
拟 环境 中 ， 不 会 影响 系统 全 局 。 现 在 执行 ls -1a 命令 ， 你 会 看 到 有 个 .virtualenvs 目录 。 虚 拟 环 

境 和 相关 的 包 都 存储 在 这 里 。 为 了 确认 一 切 正常 ， 执 行 which pip 命令 。 这 个 命令 打印 当前 激活 

的 pip 二 进 制 文件 的 位 置 ， 我 们 希望 它 在 rango 虚拟 环境 中 。 


/home/<username>/.virtualenvs/test/bin/pip 


RE Ee SEL, MÍT pip list 命令 。 接 下 来 我 们 要 定制 虚拟 环境 ， 安 装 Rango 应 用 所 需 
的 包 。 执 行 下 述 命令 : 


$ pip install -U django==1.9.10 

$ pip install pillow 

$ pip install django-registration-redux 
$ pip install django-bootstrap-toolkit 


切记 把 Django 的 版 本 替换 为 你 在 开发 过 程 中 使 用 的 版 本 。 如 若 不 然 ， 很 有 可 能 遇 到 各 种 奇怪 的 问 
题 ， 让 你 百 思 不 解 。 你 也 可 以 在 自己 的 电脑 中 执行 pip freeze > requirements.txt 命令 ,保存 当 
前 开发 环境 ， 然 后 在 PythonAnywhere 中 执行 pip install -r requirements.txt 命令 ,一 次 安装 
全 部 包 。 


k 静 候 下 载 …… 


安装 包 的 过 程 可 能 要 花 些 时 间 ， 趁 机 你 可 以 放松 一 下 、 给 朋友 打 个 电话 或 者 发 推 评价 一 下 本 


书 。 


安装 好 之 后 ， 执 行 which django-admin. py 命令 检查 Django 有 没有 安装 。 正 常情 况 下 应 该 看 到 类 
似 下 面 的 输出 : 
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/home/<username>/.virtualenvs/rango/bin/django- admin. py 


太 PythonAnywhere 上 的 虚拟 环境 太 


PythonAnywhere 也 提供 了 搭建 虚拟 环境 的 说 明 ， 详 情 参见 维基 。 


切换 虚拟 环境 
在 虚拟 环境 之 间 切 换 十 分 容易 。PythonAnywhere 能 为 你 代劳 。 下 面 简要 说 明 如 何 切换 虚拟 环境 。 
若 想 进 入 某 个 虚拟 环境 ， 在 终端 执行 workon 命令 。 例 如 ， 下 述 命令 进入 rango 环境 ; 


16:48 ~ $ workon rango 


请 把 rango 换 成 你 想 使 用 的 虚拟 环境 名 称 。 执 行 这 个 命令 之 后 ， 提 示 符 会 改变 ， 指 明 你 在 一 个 虚 
拟 环 境 中 。 例 如 下 方 的 (rango), 


(rango) 16:49 ~ $ 


如 果 想 离开 虚拟 环境 ， 执 行 deactivate 命令 。 离 开 后 ， 提 示 符 中 的 (rango) 会 消失 不 见 ， 如 下 所 
示 : 


(rango) 16:49 ~ $ deactivate 


16:51 ~ $ 


克隆 Git 仓库 


搭建 好 虚拟 环境 之 后 ， 克 隆 Git 仓库 ， 获 取 项 目 文件 。 执 行 下 述 命令 克隆 仓库 : 
$ git clone https: //<USERNAME>:<PASSWORD>@github.com/<OWNER>/<REPO_NAME>.git 


请 把 <USERNAME> 替换 为 你 的 GitHub 用 户 名 ， 把 <PASSWORD> 替换 为 你 的 GitHub 账户 密码 ， 把 
<OWNER> 替换 为 仓库 拥有 者 的 用 户 名 ， 把 <REPO_NAME> 替换 为 仓库 的 名 称 。 


设置 数据 库 


源码 克隆 好 之 后 ， 接 下 来 要 准备 数据 库 。 我 们 将 使 用 本 书 前 面 创建 的 populate_rango py 模块 填充 
数据 库 ， 为 此 ， 确 保 你 在 rango 虚拟 环境 中 ( 即 提示 符 前 有 (rango)) 。 如 果 不 在 这 个 虚拟 环境 
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HH, $447 workon rango 命令 。 从 家 目录 进入 tango_with_django_19 目录 ， 再 进入 code 目录 。tan- 
go_with_django_19 目录 应 该 跟 你 的 Git 仓库 同名 ， 如 果 你 的 仓库 名 为 tvd， 那 这 个 目录 的 名 称 就 
是 wd。 如 果 你 的 仓库 结构 与 这 里 不 同 ， 你 要 进入 manage.py 脚本 所 在 的 目录 。 然 后 执行 下 述 命 


今 : 


(rango) 16:55 ~/tango_with_django $ python manage.py makemigrations rango 
(rango) 16:55 ~/tango_with_django $ python manage.py migrate 

(rango) 16:56 ~/tango_with_django $ python popuLlate_rango.py 

(rango) 16:57 ~/tango_with_django $ python manage.py createsuperuser 


第 一 个 命令 为 Rango 应 用 创建 迁移 ，migrate 命令 创建 SQLite3 数据 库 。 创 建 好 数据 库 之 后 ， 填 
充 数据 ， 再 创建 一 个 超级 用 户 。 


18.4 设置 Web 应 用 


接 下 来 要 配置 PythonAnywhere 的 Nginx Web 服务 器 ， 何 服 我 们 的 应 用 。 在 PythonAnywhere 的 控 
制 面板 中 点 击 “Open Web tab” 按 钮 。 在 打开 的 页 面 中 ， 点 击 "Add a new web app”, 


此 时 会 弹出 一 个 对 话 框 。 按 照 页 面 中 的 说 明 填写 信息 ， 随 后 点 击 “manual configuration” (手动 配 
置 ) ， 然 后 关闭 向 导 。 注 意 ， 选 择 的 Python 版 本 要 与 创建 虚拟 环境 时 指定 的 一 致 。 


在 Web 浏览 器 中 打开 一 个 新 标签 页 或 窗口 ， 访 问 PythonAnywhere 为 你 分 配 的 二 级 域名 ， 
http://<username>.pythonanywhere.com。 现 在 你 应 该 看 到 默认 的 “Hello, World!* 页 面 ， 如 图 18-2 所 
示 。 这 是 因为 现在 伺服 网 页 的 是 WSGI 脚本 ， 而 不 是 你 的 Django 应 用 。 下 面 我 们 就 要 改过 来 。 


eee () Web app setup : rangodemo2! x / [} Python Anywhere hosted web x David 


GCG OQ rangodemo2018.pythonanywhere.com 2 ongo 


Hello, World! 


This is the default welcome page for a PythonAnywhere hosted web application. 


Find out more about how to configure your own web application by visiting the web app setup page 


图 18-2: PythonAnywhere 默认 的 “Hello, World!” H & 
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配置 虚拟 环境 


在 PythonAnywhere 界面 中 的 “Web” 标 签 页 ， 向 下 滚动 ， 直 到 看 到 “Virtualenv” 标 题 。 


输入 虚拟 环境 的 路 径 。 假 设 你 的 虚拟 环境 名 为 rango， 那 么 输入 的 路 径 是 : 
/home/<username>/.virtualenvs/rango 

你 可 以 打开 控制 台 ， 确 认 一 下 。 

然后 找到 “Code ”部 分 ， 设 定 Web 应 用 源码 的 路 径 : 


/home/<username>/<path-to>/tango_with_django_project/ 


注意 ， 这 个 路 径 应 该 指向 manage py 文件 所 在 的 目录 。 假 如 你 从 名 为 tango_with_django_19 的 仓 
库 中 克隆 源码 ， 放 在 服务 器 的 家 目录 中 ， 那 么 这 个 路 径 应 该 设 为 ; 


/home/<username>/tango_with_django_19/code/tango_with_django_project/ 
配置 WSGI 脚本 
Web Server Gateway Interface (WSGI, Web 服务 器 网 关 接 口 ) 为 Web 服务 器 和 Web 应 用 提供 通 


用 的 接口 。PythonAnywhere 使 用 WSGI 建立 服务 器 与 应 用 之 间 的 连接 ， 把 人 站 请 求 映射 到 为 你 的 
Web 应 用 分 配 的 二 级 域名 。 


下 面 配置 WSGI 脚本 。 在 PythonAnywhere 的 界面 中 打开 “Web” 标 签 页 ， 在 “Code” 标 题 下 有 个 链 
接 ， 指 向 WSGI 文件 ， 路 径 为 /var/www/<username>_pythonanywhere_com_wsgipy。 


PythonAnywhere 为 我 们 提供 了 一 个 示例 WSGI 文件 ， 为 多 个 不 同 的 使 用 场景 提供 了 配置 。 这 里 ， 
我 们 要 配置 Django 那 部 分 。 点 击 链接 ， 打 开 编辑 器 。 下 面 是 针对 Rango 应 用 的 配置 。 


import os 


import sys 


# 把 项 目 所 在 的 目录 添加 到 PYTHONPATH 中 
path = '/home/<username>/<path-to>/tango_with_django_project/' 
if path not in sys.path: 

sys.path. append(path) 


# 进入 项 目 所 在 的 目录 
os.chdir(path) 
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# 告诉 Django, settings.py 模块 在 哪里 
os.environ.setdefauLlt('DJANGO_SETTINGS MODULE', 
'tango_with_django_project.settings') 


# 导入 Django 项 目的 配置 
import django 
django.setup() 


# $A Django WSGI， 处 理 请 求 
import django.core.handlers.wsgi 
application = django.core.handlers.wsgi.WSGIHandler() 


记得 把 <username> 替换 为 你 的 PythonAnywhere 用 户 名 ， 并 根据 实际 情况 修改 上 述 配 置 。WSGI 
配置 脚本 中 的 其 他 代码 都 应 删除 ， 以 防 冲 突 。 


这 个 脚本 把 项 目 所 在 的 目录 添加 到 PYTHONPATH 中 ， 这 样 Python 才能 访问 到 项 目 中 的 模块 。 如 果 
有 其 他 路 径 要 添加 到 PYTHONPATH 中 ， 可 以 继续 添加 。 随 后 指定 项 目的 settings py 模块 所 在 的 位 
置 。 最 后 ， 导 入 Django 的 WSGI 处 理 程序 ， 启 动 应 用 。 


修改 好 WSGI 配置 之 后 ， 点 击 右 上 角 的 “Save” 按 钮 。 回 到 “Web” 标 签 页 ， 点 击 页 面 顶部 的 “Reload” 
按钮 (那个 绿色 的 大 按钮 ) 。 应 用 重新 加 载 之 后 ， 再 次 访问 PythonAnywhere 为 你 分 配 的 二 级 域 
名 。 如 果 一 切 顺 利 ， 你 应 该 看 到 应 用 正常 运行 起 来 了 。 和 否则 ， 仔 细 检 查 WSGI 配置 脚本 和 各 个 路 
fZ. WARF] DisallowedHost 异常 ， 参 照 下 一 小 节 的 步 又 解决 。 


* Bad Gateway 错误 * 


在 测试 的 过 程 中 ， 笔 者 发 现 有 时 会 出 现 “HTTP 502 - Bad Gateway 错误 。 遇 到 这 个 错误 ， 请 


重新 加 载 应 用 ， 然 后 等 一 段 时 间 。 如 果 问 题 依旧 ， 再 重新 加 载 试 试 。 如 果 这 个 问题 始终 存 
在 ， 查 看 日 记 文 什 ， 看 看 有 没有 报错 ， 然 后 联系 PythonAnywhere 的 客服 。 


接受 你 的 主机 名 


Django 新 版 引入 了 一 项 安全 措施 ， 即 接受 的 主机 。 只 允许 Web 服务 器 伺服 特定 的 域名 ， 能 降低 
应 用 被 HTTP Host 首部 攻击 的 影响 。 首 次 运行 应 用 时 ， 可 能 会 遇 到 DisallowedHost 异常 ， 阻 碍 应 
用 加 载 。 


这 个 问题 容易 解决 ， 只 需 修改 项 目的 settings py HR, AIC, if PythonAnywhere 为 你 分 配 的 二 
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级 域名 。 入 门 账户 的 域名 格式 为 http://<username>.pythonanywhere.com， 其 中 <username> 是 你 的 
PythonAnywhere 用 户 名 。 最 好 在 本 地 (你 的 电脑 中 ) 编辑 这 个 文件 ， 然 后 把 改动 提交 到 Git 仓 
库 ， 推 送 到 远程 仓库 之 后 ， 再 拉 取 到 PythonAnywhere 的 服务 器 。 当 然 ， 也 可 以 在 PythonAny- 
where 的 Web 界面 中 编辑 这 个 文件 ， 或 者 在 终端 里 使 用 文本 编辑 器 (如 nano 或 vi) 编辑 。 


打开 项 目的 settings py 模块 ， 找 到 ALLOWED_HOSTS 列表 (文件 顶部 附近 ) 。 这 个 列表 默认 是 空 的 ， 
把 PythonAnywhere 为 你 分 配 的 二 级 域名 添加 进去 : 


ALLOWED_HOSTS = ['http://<username>.pythonanywhere.com' ] 


如 果 你 是 在 本 地 电脑 中 编辑 的 ， 现 在 要 执行 几 个 命令 ， 把 改动 推送 到 Git 仓库 中 : git add 
settings.py, git commit 和 git push。 然 后 执行 git pull 命令 ， 把 改动 拉 取 到 PythonAnywhere 
的 服务 器 中 。 如 果 你 是 在 PythonAnywhere 中 编辑 的 ， 直 接 保存 文件 即 可 。 


接 下 来 ， 点 击 PythonAnywhere 界面 中 的 “Reload” 按 钮 ， 重 新 加 载 应 用 。 现 在 访问 PythonAnywhere 
为 你 分 配 的 二 级 域名 ， 应 该 看 到 应 用 能 正常 运行 起 来 了 。 但 是 ， 静 态 文 件 还 不 能 用 。 


设 定 静 态 文件 路 径 


部 署 工作 就 快 结束 了 。 目 前 还 有 一 个 问题 要 解决 :为 应 用 设 定 一 些 路 径 。 比 如 ， 我 们 要 让 Pytho- 
nAnywhere 的 服务 器 能 找到 静态 文件 。 


在 PythonAnywhere 的 控制 面板 中 点 击 应 用 的 URL， 在 打开 的 页 面 中 找到 “Static fies”" 标题。 我 们 
要 填写 正确 的 URL 和 文件 系统 路 径 ， 让 PythonAnywhere 的 服务 器 找到 并 伺服 静态 文件 。 


首先 ， 设 定 Django 管理 后 台 的 静态 文件 位 置 。 点 击 “Enter URL”* 链 接 ， 输 入 /static/admin/， 点 击 勾 
号 确认 。 然 后 点 击 "Enter path”* 链 接 ， 输 入 下 述 文件 系统 路 径 : 


/home/<username>/.virtualenvs/rango/lib/<python-version>/site-packages/django/ 
contrib/admin/static/admin 


同样 ， 要 把 <username> 换 成 你 的 PythonAnywhere 用 户 名 。 此 外 ， 根 据 你 使 用 的 Python 版 本 ， 把 
<python-version> 替换 为 python2.7、python3.6 等 。 如 果 你 的 虚拟 环境 没有 命名 为 rango， 还 要 
把 它 替 换 为 你 自己 的 值 。 输 入 完成 后 按 回 车 键 ， 或 者 点 击 勾 号 。 


DATA PEN AR RR YS HI URL /static/ 和 文件 系统 路 径 /home/<username>/<path-to>/tango_with_djan- 
go_project/static, Y€ Web 应 用 的 static 目录 。 


设 定好 之 后 ， 点 击 页 面 项 部 的 “Reload” 按 钮 ， 重 新 加 载 应 用 。 注 意 ， 可 能 会 出 现 HTTP 502 - Bad 
Gateway 错误 。 重 新 加 载 后 ， 你 的 Web 应 用 应 该 能 正确 显示 图 像 等 静态 文件 了 。 
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搜索 API 密 钥 


把 你 的 搜索 API 密 钥 保存 在 search.key 文件 中 ， 供 Rango 的 搜索 功能 使 用 。 


关闭 调试 模式 


应 用 运行 起 来 之 后 ， 最 好 告诉 Django， 现 在 你 的 应 用 贮存 在 生产 服务 器 中 。 为 此 ， 打 开 项 目的 

settings py 文件 ， 把 DEBUG = True 改 成 DEBUG = False。 这 样 修改 之 后 ，Django 的 调试 模式 关闭 

了 ， 包 含 敏感 信息 的 错误 消息 也 不 会 显示 了 。 尽 管 如 此 ， 你 还 是 能 看 到 出 错时 的 堆栈 跟踪 (参见 
下 一 节 ) 。 


18.5 日 志文 件 


把 Web 应 用 部 署 到 线 上 环境 又 增加 了 一 层 复杂 度 。 换 了 环境 ， 可 能 出 现 新 的 问题 ， 有 些 还 让 人 摸 
不 着 头脑 。 遇 到 错误 时 ， 可 以 在 PythonAnywhere 创建 的 三 个 日 志文 件 中 寻找 线索 。 


这 些 日 志文 件 可 以 在 PythonAnywhere 界面 中 的 “Web” 标 签 页 里 查看 ， 也 可 以 在 Bash 控制 台中 直 
接 查 看 /var/log/ 目录 里 的 文件 。 


PythonAnywhere 创建 的 三 个 日 志文 件 如 下 : 


J access.log: 记录 对 应 用 的 请 求 信 息 
4 error.log: 记录 Web 应 用 产生 的 错误 消息 
A server.log: 记录 运行 应 用 的 Unix 进程 的 详细 信息 


注意 ， 各 日 志文 件 名 的 前 面 有 PythonAnywhere 为 你 分 配 的 二 级 域名 。 例 如 access.log 文件 的 全 名 


为 <username> pythonanywhere.com.access.log 


祝贺 你 ， 你 成 功 部 署 了 Rango 应 用 | 


J 把 你 的 应 用 网 址 通过 Twitter 布告 天 下 ， 并 @tangowithdjango, 
J 通过 Twitter 或 电子 邮件 告诉 我 们 你 对 本 书 的 看 法 。 
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结语 


本 书 带 领 你 开发 了 一 个 完整 的 Web 应用， 从 提出 要 求 到 最 终 部 署 ， 整 个 过 程 一 步 不 落 。 在 这 个 过 
程 中 ， 本 书展 示 了 如 何 为 Web 应 用 编写 模型 、 视 图 和 模板 。 此 外 还 用 到 了 一 些 工 具 包 和 服务 ， 例 
如 Bootstrap, jQuery 和 PythonAnywhere。 然 而 ， 前 面 的 路 还 很 长 。 我 们 只 是 勾勒 出 了 Rango 应 用 
的 整体 结构 ， 还 有 很 多 地 方 可 以 改进 。 而 改进 细节 的 时 候 往 往 要 花 更 多 的 时 间 和 精力 。 和 希望 本 书 
能 为 你 打下 坚实 的 基础 ， 让 你 能 大 步 向 前 ， 不 断 进 取 。 


如 果 你 发 现 本 书 内 容 有 问题 ， 欢 迎 通 过 GitHub 反馈 给 我 们 。 


感谢 你 阅读 本 书 ! 


205 


设置 系统 


本 篇 附录 简要 说 明 开 发 Django 应 用 所 需 的 几 个 组 件 。 


x 选择 一 个 Python 版 本 * 


Django 既 支 持 Python 2.7.x， 也 支持 Python 3。 虽 然 这 只 是 同一 门 编程 语言 的 两 个 版 本 ， 但 


是 二 者 之 间 有 本 质 上 的 区 别 。 本 篇 附录 假设 你 使 用 Python 2.7.5。 请 根据 自己 的 需要 安装 其 
他 版 本 。 


A.1 安装 Python 


你 的 电脑 中 可 能 已 经 预 装 了 Python。 如 果 你 使 用 的 是 Linux 发 行 版 或 macOS， 肯 定 是 安装 了 的 。 
因为 这 些 操作 系统 的 部 分 功能 就 是 使 用 Python 实现 的 ， 所 以 必须 要 有 Python 解释 器 。 不 过 ， 几 
乎 所 有 现代 的 操作 系统 预 装 的 Python 版 本 都 比 本 书 所 要 求 的 版 本 低 。 


Python 有 很 多 安装 方式 ， 而 且 大 都 繁杂 。 下 面 说 明 最 常用 的 安装 方式 ， 再 给 出 一 些 链接 ， 供 你 参 
考 。 


© 不 要 删除 默认 安装 的 Python + 


本 节 说 明 如 何在 不 动 预 装 Python 的 情况 下 安装 Python 2.7.5。 千 万 不 要 把 操作 系统 默认 安装 
的 Python 删 掉 ， 或 者 蔡 换 为 较 新 的 版 本 。 否 则 ， 操 作 系统 的 部 分 功能 可 能 失效 。 
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macOS 


在 macOS 系统 中 安装 Python 2.7.5 最 简单 的 方式 要 数 官方 提供 的 安装 程序 。Python 安装 程序 的 下 
载 地 址 为 http:Wwww.python.org/getit/releases/2.7.5/。 


E 注意 选择 版 本 罩 


一 定 要 下 载 针 对 相应 macOS 版 本 的 dmg 文件 。 


O 双击 下 载 得 到 的 dmg 文件 ， 弹 出 一 个 Finder 窗口 ， 挂 载 安装 程序 。 

@ 双击 Python.mpkg， 打 开 Python 安装 程序 。 

O 不 断 点 击 按钮 ， 直 到 开始 安装 。 安 装 之 前 ， 系 统 可 能 会 要 求 你 输入 密码 。 
O 安装 完毕 后 关闭 安装 程序 ， 弹 出 挂 载 的 磁盘 。 删 除 dmg 文件 。 


这 样 就 安装 好 了 较 新 的 Python 版 本 ， 可 以 开始 开发 Django 应 用 了 。 简 单 吧 ? 如 果 你 想 使 用 
Python 3， 也 可 以 这 样 安装 。 


Linux 发 行 版 


在 Linux 发 行 版 上 安装 Python 的 方式 多 种 多 样 ， 而 且 不 同 的 发 行 版 也 有 所 区 别 。 人 例如， 在 Fedora 
上 安装 Python 的 方式 就 与 在 Ubuntu 上 安装 的 方式 不 同 。 


但 也 不 要 灰心 。 有 个 工具 能 帮 我 们 解决 这 个 这 个 难题 一 一 pythonbrew。 使 用 这 个 工具 能 轻易 安装 
和 管理 不 同 的 Python 版 本 ， 而 且 对 操作 系统 默认 的 Python 没有 影响 。 


根据 pythonbrew 项 目的 说 明和 Stack Overflow 中 的 这 个 问答 ， 在 Linux 发 行 版 中 安装 Python 2.7.5 
的 步骤 如 下 。 
@ 打开 终端 。 


@ 执行 命令 curl -kL http://xrl.us/pythonbrewinstall | bash， 下 载 pythonbrew 安装 脚 
本 ， 在 终端 里 执行 。pythonbrew 安装 在 ~/ pythonbrew 目录 中 (~ 表示 家 目录 ) 。 


@ 在 文本 编辑 占 〈 例 如 gedit, nano, vi 或 emacs) 中 打开 ~/.bashre 文件 ， 把 这 一 行 添加 到 末 
Æ: [[ -s SHOME/.pythonbrew/etc/bashrc ]] && source $HOME/.pythonbrew/etc/bashrc, 


O 保存 ~bashre 文件 ， 关 闭 当前 终端 窗口 ， 重 新 打开 一 个 ， 让 改动 生效 。 
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© 执行 命令 pythonbrew install 2.7.5, #28 Python 2.7.5, 


© 执行 pythonbrew switch 2.7.5 命令 ， 切 换 到 Python 2.7.5, 


* 隐藏 的 目录 和 文件 & 


名 称 以 点 号 开头 的 目录 和 文件 相当 于 Windows 系统 中 的 隐藏 文件 。 点 文件 通常 在 目录 浏览 


工具 中 不 显示 ， 经 常用 作 配 置 文件 。 执 行 1s 命令 时 加 上 -a 选项 能 看 到 隐藏 文件 ， 即 1s 


-do 


Windows 


微软 Windows 系统 没有 预 装 Python。 因 此 我 们 无 需 担心 会 对 现 有 的 版 本 有 什么 影响 ， 直 接 安 装 就 
好 了 。 可 以 从 Python 官网 下 载 64 位 或 32 位 的 安装 程序 。 如 果 不 知 道 该 下 载 哪个 版 本 ， 按 照 微软 
网 站 中 的 说 明 查 看 自己 的 电脑 是 32 位 还 是 64 位 。 


O 安装 程序 下 载 好 之 后 ， 双 击 打 开 。 
@ 按照 界面 上 的 提示 安装 Python。 
O 安装 完毕 后 关闭 安装 程序 ， 把 安装 程序 删除 。 


默认 情况 下 ，Python 2.7.5 安装 在 C:\Python27 文件 夹 中 。 建 议 不 要 改动 这 个 路 径 。 


安装 完成 后 ， 打 开 命 令 提 示 符 ， 输 入 python 命令 。 如 果 看 到 Python 提示 符 ， 说 明 安 装 是 成 功 
的 。 然 而 ， 安 装 程序 有 时 无 法 正确 设 定 Path 环境 变量 ， 导 致 找 不 到 python 命令 。 在 Windows 7 
中 可 以 这 样 解决 : 


点 击 “ 开 始 ” 按 钮 ， 在 “计算 机 ”上 点 击 鼠 标 右键 ， 在 弹出 的 菜单 中 选择 “属性 ”。 

点 击 “ 高 级 系统 设置 "链接 。 

点 击 “ 坏 境 变量 "按钮 。 

在 “系统 变量 ”列表 中 找到 Path， 选 中 ， 然 后 点 击 “ 编 辑 ” 按 钮 。 

在 末尾 添加 ;C:\python27;C:\python27\scripts。 别 漏 了 分 号 ， 也 别 添加 任何 空格 。 
点 击 各 对 话 框 中 的 “确定 按钮， 保存 改动 。 

关闭 命令 提示 符 ， 重 新 打开 ， 再 执行 python 命令 试 试 。 


© © © © © © © 


这 样 Python 就 能 正常 使 用 了 。 在 Windows 10 中 的 步 桑 稍 有 不 同 。 
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A.2 设置 PYTHONPATH 


安装 好 Python 之 后 ， 我 们 要 检查 安装 是 否 成 功 。 为 此 要 检查 有 没有 正确 设置 PYTHONPATH 环境 变 
量 。PYTHONPATH 变量 告诉 Python 解释 器 增强 Python 功能 的 包 和 模块 在 什么 位 置 。 如 未 正确 设置 
PYTHONPATH， 我 们 便 无 法 安装 和 使 用 Django, 


HAIG, WA PYTHONPATH 变量 是 否 存在 。 有 的 安装 方法 可 能 会 设 定 这 个 变量 ， 有 的 则 不 会 。 在 基于 
Unix 的 操作 系统 中 执行 下 述 命令 : 


$ echo $PYTHONPATH 
在 Windows 系统 中 执行 执行 : 
$ echo %PYTHONPATH% 


如 果 一 切 正 常 ， 应 该 看 到 类 似 下 面 的 输出 。 在 Windows 中 显然 会 看 到 Windows 风格 的 路 径 ， 很 
有 可 能 是 C 盘 下 的 路 径 。 


/opt/local/Library/Frameworks/Python.framework/ 
Versions/2.7/lib/python2.7/site-packages: 


这 是 Python 安装 目录 下 的 site-packages 目录 ， 人 额外 的 Python 包 和 模块 都 保存 在 这 里 。 如 果 看 到 
类 似 的 路 径 ， 请 跳 到 A3 节 。 在 Windows 系统 中 ，site-packages 目录 在 Python 安装 目录 下 的 Lib 
目录 里 。 如 果 Python 安装 在 CAPython27, HRA site-packages 目录 的 路 径 是 C\Python2 入 Libsite- 
packages\, 


基于 Unix 的 操作 系统 要 经 过 一 番 曲 折 才 能 找 出 site-packages 目录 的 路 径 。 打 开 Python 解释 器 ， 执 
行 下 述 命令 : 

$ python 

Python 2.7.5 (v2.7.5:ab05e7dd2788, May 13 2013, 13:18:45) 

[GCC 4.2.1 (Apple Inc. build 5666) (dot 3)] on darwin 


Type "help", "copyright", "credits" or "License" for more information. 


>>> import site 
>>> print(site.getsitepackages()[0]) 


'/Library/Frameworks/Python. framework/Versions/2.7/lib/python2.7/site-packages' 


>>> quit() 
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site.getsitepackages() 返回 一 组 存储 额外 Python 包 和 模块 的 路 径 ， 第 一 个 通常 就 是 site-pack- 
ages 目录 的 路 径 。 如 果 报 错 getsitepackages() 不 在 site 模块 中 ， 确 保 你 运行 的 是 正确 的 Python 
版 本 。2.7.5 版 应 该 有 这 个 函数 ， 之 前 的 版 本 则 没有 。 


找到 site-packages 目录 的 路 径 后 ， 将 其 添加 到 配置 中 。 在 基于 Unix 的 操作 系统 中 ， 再 次 编辑 
-bashre 文件 ， 把 下 述 代 码 添加 到 文件 末尾 : 


export PYTHONPATH=$PYTHONPATH:<PATH_TO_SITE-PACKAGES> 


把 <PATH_TO_SITE-PACKAGES> 替换 为 site-packages 目录 的 具体 路 径 。 保 存 文件 后 ， 关 闭 当前 终端 窗 
口 ， 重 新 打开 一 个 。 


在 Windows 系统 中 ， 参 照 前 文 ， 打 开 环 境 变量 设置 对 话 框 。 添 加 PYTHONPATH 变量 ， 把 值 设 为 
site-packages 目录 的 路 径 ， 通 常 是 CA\Python2 入 Lib\site-packages\。 


A.3 使 用 setuptools 和 pip 


搭建 开发 环境 是 任何 项 目的 基础 工作 。 虽 然 可 以 单独 安装 Python 包 ， 但 是 这 会 导致 诸多 问题 ， 为 
以 后 带 来 许多 麻烦 。 侈 如 ， 你 怎么 把 自己 的 环境 分 享 给 其 他 开发 者 呢 ? 如 何在 新 设备 中 搭建 相同 
的 环境 呢 ?” 如 何 升 级 到 包 的 最 新 版 呢 ? 使 用 包 管理 器 搭建 环境 能 免 去 很 多 麻烦 事 。 


本 书 使 用 的 包 管理 器 是 pip， 这 是 对 Python 包 管 理 器 setuptools 的 包装 ， 对 用 户 友好 。 因 为 pip 依 
fii setuptools， 因 此 这 两 个 工具 都 要 安装 。 


首先 ， 从 Python 包 官 方 网 站 下 载 setuptools。 可 以 下 载 tar.gz 压缩 文件 。 使 用 你 喜欢 的 解压 工 
具 ， 把 里 面 的 文件 提取 出 来 。 解 压 出 来 的 目录 通常 是 setuptools-1.1.6， 其 中 1.1.6 是 setuptools 的 
版 本 号 。 打 开 终 端 ， 进 入 这 个 目录 ， 运 行 ez_setup .py 脚本 : 


$ cd setuptools-1.1.6 
$ sudo python ez_setup.py 


这 里 我 们 使 用 sudo 运行 脚本 ， 进 行 系统 全 局 安装 。 如 果 安 装 成 功 ， 会 看 到 类 似 下 面 的 输出 : 
Finished processing dependencies for setuptools==1.1.6 


SYR, 1.1.6 会 显示 为 你 安装 的 具体 版 本 号 。 如 果 能 看 到 这 行 输出 ， 接 下 来 就 可 以 安装 pip 了。 在 
终端 里 执行 下 述 命令 : 


9 sudo easy_install pip 


这 个 命令 下 载 并 安装 pip， 同 样 也 是 系统 全 局 安装 。 如 果 看 到 下 述 输 出， 说 明 安 装 是 成 功 的 : 
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Finished processing dependencies for pip 


随后 便 可 以 在 终端 执行 pip 命令 。 既 然 已 经 成 功 安装 ， 你 不 会 看 到 无 法 识别 命令 的 提醒 ， 而 是 会 
看 到 pip 支持 的 一 系列 命令 和 选项 。 


E Windows 中 没有 sudo E 


在 Windows 中 的 安装 过 程 基 本 差不多 ， 但 是 无 需 输 入 sudo。 


A.4 虚拟 环境 


开发 环境 就 要 搭建 好 了 。 目 前 所 做 的 一 切 足够 我 们 开始 着 手 开发 了 ， 但 是 还 有 一 些 不 足 。 如 有 果 另 
一 个 Python 应 用 需要 使 用 不 同 的 版 本 该 怎么 办 呢 ? 或 者 ， 如 果 你 想 切换 到 Django 的 新 版 ， 但 是 
想 继续 维护 Django 1.7 项 目 又 该 怎么 办 呢 ? 


这 些 问题 的 解决 方法 是 使 用 虚拟 环境 。 虚 拟 环境 能 让 多 个 Python 版 本 及 相同 包 的 不 同 版 本 和 谐 相 
处 。 如 今 的 开发 者 都 选择 使 用 这 种 方式 搭建 Python 开发 环境 。 只 要 有 pip， 一 切 都 好 办 。 为 了 使 
用 虚拟 环境 ， 要 安装 几 个 包 ; 


$ pip install virtualenv 
$ pip install virtualenvwrapper 


第 一 个 包 是 创建 虚拟 环境 的 基础 ， 详 情 参 见 Jamie Matthews 写 的 这 篇 文章 。 然 而 ，virtualenv 包 用 
起 来 不 是 很 顺手 。 第 二 个 包 包装 了 virtualenv 包 的 功能 ， 省 时 省 力 。 


如 果 你 使 用 的 是 基于 Linux/Unix 的 操作 系统 ， 为 了 使 用 virtualenvwrapper， 只 需 执行 一 个 shell 脚 
A 


$ source virtuaLlenvwrapper.sh 


通常 ， 我 们 会 把 这 一 行 代码 添加 到 bash/profile 脚本 中 ， 以 免 每 次 想 使 用 虚拟 环境 时 都 自己 动手 运 
行 。 


Windows 用 户 要 安装 virtualenvwrapper-win 包 : 


$ pip install virtualenvwrapper-win 


接 下 来 可 以 创建 虚拟 环境 了 : 
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$ mkvirtualenv rango 
若 想 查看 有 哪些 虚拟 环境 ， 使 用 Usvirtualenv 命令 。 下 述 命 令 激活 一 个 虚拟 环境 : 


$ workon rango 
(rango) $ 


激活 虚拟 环境 后 ， 提 示 符 中 会 显示 当前 虚拟 环境 的 名 称 ， 即 这 里 的 rango。 现 在 ， 你 可 以 放心 在 
这 个 环境 中 安装 所 需 的 包 ， 无 需 担心 会 对 其 他 环境 产生 影响 。 执 行 pip List 命令 ， 看 看 你 的 虚拟 
环境 中 有 没有 安装 Django 和 Pillow。 如 果 没有 ， 使 用 pip 把 它们 安装 到 你 的 虚拟 环境 中 。 


A.5 版 本 控制 


我 们 建议 ， 代 码 应 该 使 用 版 本 控制 工具 管理 ， 例 如 SVN 或 Git。 如 果 你 没 用 过 Git 和 GitHub, @ 
议 你 阅读 《GitHub 入 门 与 实践 》 一 书 。 我 们 建议 你 把 自己 的 项 目 纳 入 Git 仓库 ， 这 样 能 避免 很 多 
灾难 。 
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中 期 练习 参考 解答 


希望 第 14 章 给 出 的 步骤 能 协助 你 完成 练习 。 如 果 你 做 不 出 来 ， 需 要 一 点 提示 ， 请 参照 本 篇 附录 给 


出 的 方法 。 


E 有 更 好 的 方法 ? m 


这 里 给 出 的 方法 只 是 解决 问题 的 方式 之 一 。 如 果 你 以 其 他 方式 实现 了 ， 请 与 笔者 分 享 你 的 经 


验 。 还 可 以 在 Twitter 上 @tangowithdjango， 让 更 多 的 人 知道 。 


B.1 记录 网 页 的 访问 次 妆 


编写 视图 


在 /rango/views.py 模块 中 定义 一 个 新 视图 ， 命 名 为 track_urL()。 这 个 视图 从 HTTP GET 请 求 参 
数 (rango/goto/?page_id=1) 中 提出 所 需 的 信息 ， 更 新 相应 网 页 的 访问 次 数 ， 然 后 重 定向 到 真正 
的 URL, 


from django.shortcuts import redirect 


def track_url(request): 
page_id = None 
url = '/rango/' 
if request.method == 'GET': 
if 'page_id' in request.GET: 
page_id = request.GET[ ‘page _id' ] 


try: 
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page = Page.objects.get(id=page_id) 
page.views = page.views + 1 
page.save() 
url = page.url 

except: 
pass 


return redirect(url) 
别 忘 了 在 views py 模块 顶部 导入 redirect() 函数 。 


from django.shortcuts import redirect 


添加 URL 映射 


打开 /rangolurls py 模块 ， 把 下 述 代码 添加 到 urlpatterns 中 。 


url(r'^goto/$', views.track_url, name='goto'), 


修改 分 类 页 面 的 模板 
修改 category. html 模板 ， 不 让 用 户 点 击 真 正 的 URL， 而 是 使 用 rango/goto/?page_id=XXX , 


{% for page in pages %} 
<li> 
<a href="{% url 'goto' %}?page_id={{page.id}}">{{ page.title }}</a> 
{% if page.views > 1 %} 
({{ page.views }} views) 
{% elif page.views == 1 %} 
({{ page.views }} view) 
{% endif %} 
</li> 
{% endfor %} 


可 以 看 到 ， 我 们 根据 page.views 的 值 显示 “view”、“views”， 或 者 什么 也 不 显示 。 


修改 分 类 视图 


既然 已 经 记录 了 网 页 的 访问 次 数 ， 那 么 可 以 更 改 category() 视图 ， 按 访问 次 数 排序 网 页 : 
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pages = Page.objects.filter(category=category).order_by('-views') 


点 击 几 个 链接 ， 然 后 返回 分 类 页 面 ， 确 认 一 切 正常 。 再 看 看 其 他 分 类 页 面 。 


B.2 在 分 类 页 面 中 搜索 
去 掉 搜 索 页 面 


首先 要 删除 独立 的 搜索 页 面 ， 只 让 用 户 在 分 类 页 面 中 搜索 。 为 此 ， 要 删除 现在 的 搜索 页 面 及 其 视 
图 。 


然后 ， 修 改 base htm 模板 ， 把 导航 栏 中 的 “Search” 链 接 删 掉 。rango/urls.py 模块 中 的 URL 映射 也 
要 删除 。 


添加 搜索 表单 


打开 category.html 模板 ， 在 网 页 列表 下 方 添加 搜索 表单 。 这 与 search html 模板 中 的 代码 差不多 ， 
但 是 要 把 action 属性 指向 show_category 页 面 。 此 外 还 要 传人 query 变量 ， 让 用 户 知道 自己 搜索 
的 是 什么 。 


<form class="form-inline" id="user_form" 

method="post" action="{% url 'show category' category.slug %}"> 

{% csrf_token %} 

<div class="form-group"> 
<input class="form-control" type="text" size="50" 

name="query" value="{{ query }}" id="query" /> 

</div> 

<button class="btn btn-primary" type="submit" name="submit" 
value="Search">Search</button> 


</form> 
表单 下 方 显 示 搜 索 结 果 。 同 样 ， 模 板 代 码 也 与 search.html 模板 中 的 类 似 。 


<div> 

{% if result list %} 
<h3>Results</h3> 
<!-- 按 顺 序 显 示 搜 索 结 果 --> 


<div class="list-group"> 
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{% for result in result_list %} 
<div class="List-group-item"> 
<h4 class="List-group-item-heading"> 
<a href="{{ result.link }}">{{ result.title }}</a> 
</h4> 
<p class="List-group-item-text">{{ result.summary }}</p> 
</div> 
{% endfor %} 
</div> 
{% endif %} 


</div> 


别 忘 了 把 搜索 表单 和 搜索 结果 放 在 {% if user.authenticated %} 和 {% endif %} 之 间 ， 只 让 通过 
身份 验证 的 用 户 搜 索 ， 以 免 访 客 浪费 有 限 的 API 使 用 额度 。 


修改 分 类 视图 
修改 show_category() 视图 ， 处 理 HTTP POST 请 求 ， 并 把 搜索 结果 列表 传 给 模板 上 下 文 。 


def show_category(request, category_name_slug): 
# 创建 上 下 文字 典 ， 稍 后 传 给 模板 泻 染 引擎 
context_dict = {} 


try: 
# 能 通过 传 入 的 分 类 别名 找到 对 应 的 分 类 吗 ? 
# 如 果 找 不 到 ，.get() 方法 抛 出 DoesNotExist 异常 
# 因此 .get() 方法 返回 一 个 模型 实例 或 抛 出 异常 
category = Category.objects.get(slug=category_name_slug) 
# 检索 关联 的 所 有 网 页 
# 注意 ，filter() 返回 一 个 网 页 对 象 列 表 或 空 列 表 
pages = Page.objects.filter(category=category) 


# 把 得 到 的 列表 赋值 给 模板 上 下 文中 名 为 pages 的 键 
context_dict['pages'] = pages 
# 也 ,把 从 数据 库 中 获取 的 category 对 象 添加 到 上 下 文字 典 中 
# 我 们 将 在 模板 中 通过 这 个 变量 确认 分 类 是 否 存在 
context_dict['category'] = category 

except Category.DoesNotExist: 
# 没 找到 指定 的 分 类 时 执行 这 里 
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# 什么 也 不 做 

# 模板 会 显示 消息 ， 指 明 分 类 不 存在 
context_dict['category'] = None 
context_dict['pages'] = None 


# 新 添加 的 处 理 POST 请 求 的 代码 


# 设 定 一 个 默认 的 搜索 词 条 (PRE) ， 显 示 在 搜索 框 中 


context_dict['query'] = category.name 


result_list = [] 
if request.method == 'POST': 
query = request.POST[ 'query'].strip() 


if query: 
# 向 搜索 API 发 起 请 求 ， 获 得 结果 列表 
resuLt_list = run_query(query) 
context_dict['query'] = query 
context_dict['resuLt_list'] = result_list 


# BRAS, BRAR P i 
return render(request, 'rango/category.html', context_dict) 


YER, context_dict 现在 多 了 result_list 和 query。 如 果 没 有 搜索 词 条 ， 使 用 默认 的 值 ， 即 分 类 
名 。 这 个 值 在 搜索 框 中 显示 。 
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eee p] Rango - How to Tango with D x David 


€ CG | © 127.0.0.1:8000/rango/category/python/ *y/G8O090@: 


Type to finda Python 
category 
64 people like this category Hi? 


e Official Python Tutorial€Zp 
e How to Think like a Computer Scientist@Zp 
e Learn Python in 10 Minutes@ 


Add a Page 
python for loop | Search | 
Results 
ForLoop - Python Wiki 


For loops. Usage in Python. When do I use for loops? For loops are traditionally used when 
you have a piece of code which you want to repeat n number of times. 


图 B-1: 添加 搜索 功能 后 的 分 类 页 面 


B.3 增加 个 人 资料 页 面 


本 节 为 Rango 应 用 的 用 户 增加 个 人 资料 页 面 。Django 自 带 的 User 对 象 包含 一 些 关 于 用 户 的 基本 
言 息 ， 例 如 用 户 名 和 密码 。 但 是 我 们 实现 了 UserProfile 模型 ， 存 储 一 些 额 外 信息 ， 例 如 用 户 网 
站 和 头像 。 基 本 步 又 如 下 : 


创建 profile_registration.himl 模板 ， 显 示 UserProfileForm, 
定义 UserProfileFormModelForm 类 ， 处 理 这 个 新 表单 。 
编写 register_profile() 视图 ， 捕 获 用 户 提供 的 个 人 信息 。 
把 视图 映射 到 URL rango/register_profile/ E., 


ü U U 总 


修改 MyRegistrationView 类 中 的 get_success_url() 方法 ， 把 重 定 向 地 址 改 为 rango/ 
add_profile/ , 


注册 新 用 户 的 步骤 如 下 : 


口 点 击 “Register" 链 接 。 

4 在 表单 中 填写 基本 的 信息 。 

J 在 新 增 的 UserProfileForm 表单 中 填写 额外 信息 。 
J 完成 注册 。 


220 - 附录 B 中 期 练习 参考 解答 


这 个 过 程 假设 保存 个 人 资料 表单 之 前 已 经 注册 了 用 户 。 


创建 模板 


首先 创建 一 个 模板 ， 显 示 用 于 填写 额外 信息 的 注册 表单 。 这 里 ， 为 了 便于 说 明 ， 我 们 特意 把 djan- 
go-registration-redux 表单 与 新 增 的 UserProfiLeForm 表单 分 开 。 如 果 你 想 合 并 二 者 ， 为 什么 不 试 试 
呢 ? 


在 Rango 应 用 的 模板 目录 中 新 建 一 个 模板 文件 ， 命 名 为 profile_registration.html， 写 人 下 述 HTML 
标记 和 Django 模板 代码 。 


{% extends "rango/base.html" %} 


{% block title_block %} 
Registration - Step 2 
{% endblock %} 


{% block body block %} 
<hi>Registration - Step 2</h1> 
<form method="post" action="." enctype="muLltipart/form-data"> 
{% csrf_token %} 
{{ form.as_p }} 
<input type="submit" value="Submit" /> 
</form> 
{% endblock %} 


这 与 现在 的 登录 表单 很 像 ， 也 继承 自 base.html 模板 ， 共 用 基本 的 页 面 结构 。 我 们 在 body_block 
区 块 中 添加 了 一 个 HTML 表单 ， 使 用 对 应 视图 传人 模板 的 Form 对 象 生 成 字段 。 


+ AST multipart/form-data @ 


lls SFE <form> 标签 中 设 定 enctype="multipart/form-data" 属性 ， 以 此 告诉 Web 浏览 器 和 


服务 右 ， 不 要 编码 任何 数据 ， 因 为 这 个 表单 要 处 理 文件 上 传 。 如 奉 不 然 ， 这 个 表单 将 无 法 上 
传 头像 。 
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定义 UserProfileForm 类 


Rango 应 用 的 models py 模块 中 有 个 UserProfile 模型 ， 下 面 列 出 它 的 代码 ， 以 防 你 忘 了 。 


class UserProfile(models.Model): 
# 这 一 行 是 必须 的 
# 建立 与 User 模型 之 间 的 关系 
user = models.OneToOneField(User) 


# 想 增加 的 属性 
website = models.URLField(blank=True) 
picture = models.ImageField(upload to='profile images', blank=True) 


# BS __str_() 方法 ， 返 回 有 意义 的 字符 串 
# 如 果 使 用 Python 2.7.x， 还 要 定义 __unicode _ 方法 
def _str_ (self): 


return self.user.username 


为 了 能 够 自动 生成 对 应 表单 的 HTML 标记 ， 我 们 要 根据 UserProfile 模型 定义 一 个 ModelFornm 的 
子 类 。 根 据 第 7 章 所 学 的 知识 ， 可 以 像 下 面 这 样 定 义 UserProfileForm 类 。 


class UserProfileForm(forms .ModeLForm) : 
website = forms.URLField(required=False) 
picture = forms. ImageField(required=False) 


class Meta: 
model = UserProfile 
exclude = ('user',) 


注意 ，website 和 picture 字段 是 可 选 的 (required=False) 。 我 们 在 能 套 的 Meta 类 中 指定 ， 这 个 
表单 对 应 的 模型 是 UserProfile, exclude 属性 告诉 Django, PEN user 模型 属性 生成 表单 字 

段 。 因 为 新 注册 的 用 户 还 没有 User 对 象 可 引用 ， 所 以 后 面 我 们 将 手动 关联 到 UserProfile 实例 
E; 


编写 视图 


接 下 来 要 编写 一 个 视图 ， 处 理 UserProfileForm 表单 ， 新 建 UserProfile 实例 ， 然 后 使 用 pro- 
file_registration.himl 模板 泻 染 响应 。 现 在 ， 你 应 该 知道 如 何 编写 这 样 的 视图 了 了 。 这 个 表单 既 要 能 
处 理 HTTP GET 请 求 ( 演 染 表 单 ) ， 还 要 能 处 理 HTTP POST 请 求 (处 理 输入 的 新 信息 ) 。 下 面 
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是 一 种 可 行 的 实现 方式 。 


def Wg profile(request): 
form = UserProfileForm() 


if request.method == 'POST': 


form = UserProfileForm(request.POST, request.FILES) 


if form.is_valid(): 
user_profile = form.save(commit=False) 
user_profile.user = request.user 
user_profile.save() 


return redirect('index') 
else: 


print(form.errors) 


context_dict = {'form':form} 


return render(request, 'rango/profile_registration.html', context_dict) 


创建 UserProfileForm 实例 之 后 ， 通 过 request 对 象 判 断 是 GET 请 求 还 是 POST 请 求 。 如 果 是 
POST 请 求 ， 使 用 POST 请 求 中 的 数据 重新 创建 UserProfileForm 实例 。 因 为 还 要 处 理 图 像 上 传 
(用 户 的 头像 ) ， 因 此 我 们 通过 request.FILES 获取 上 传 的 文件 。 随 后 检查 提交 的 表单 数据 是 否 


有 效 ， 即 判断 有 没有 正确 填写 表单 字段 。 这 里 只 是 检查 填写 的 URL 是 
可 选 的 。 


否 有 效 ， 因 为 两 个 字段 都 是 


如 果 提 交 的 数据 有 效 ， 创 建 UserProfile 实例 : user_profile = form.save(commit=False)。 我 们 
指定 了 commit=False 参数 ， 以 便 在 保存 到 数据 库 中 之 前 做 些 修改 。 我 们 要 做 的 是 把 UserProfile 
实例 与 前 面 创建 的 User 对 象 关联 起 来 。 成 功 保存 UserProfile 实例 后 ， 重 定向 到 index 视图 。 如 
果 出 于 什么 原因 ， 提 交 的 表单 无 效 ， 在 控制 台中 打印 错误 。 在 真实 的 代码 中 ， 你 可 能 会 想 以 更 好 


的 方式 处 理 错误 。 


如 果 是 HTTP GET 请 求 ， 说 明 只 是 想 要 一 个 空 表 单 ， 供 用 户 填 写 。 因 此 我 们 使 用 空 的 
UserProfileForm 实例 (模板 上 下 文中 的 form) 演 染 profile_registration.himl 模板 。 


如 此 一 来 ， 这 个 视图 既 能 显示 UserProfileForm 表单 ， 又 能 解析 并 保存 表单 中 填写 的 数据 。 
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@ KAZI login_required? 多 


注意 ， 新 注册 的 用 户 访问 这 个 视图 时 已 经 有 账户 了 ， 因 此 可 以 放心 地 假设 用 户 已 登录 。 因 此 
我 们 才 使 用 @login_required 装饰 器 ， 以 防 未 经 授权 的 人 访问 这 个 视图 。 


如 果 报 错 找 不 到 Login_required() 函数 〈 用 作 装 饰 器 ) ， 确 保 views.py 模块 的 项 部 有 下 述 


import 语句 。 


from django.contrib.auth.decorators import login_required 


映射 URL 


模板 和 视图 准备 好 之 后 ， 有 经 验 的 Django 开发 者 顺 其 自然 会 想到 ， 接 下 来 应 该 映射 URL T. R 
们 要 把 视图 映射 到 一 个 URL 上 ， 让 用 户 能 访问 刚 创建 的 内 容 。 打 开 Rango 应 用 的 urls.py 模块 ， 
把 下 面 这 行 代码 添加 到 urLpatterns 列表 中 。 


url(r'^register profile/$', views.register_profile, name='register_profile'), 


这 行 代码 把 新 增 的 register_profile() 视图 映射 到 URL /rango/register_profile/ 上 。 还 记得 吗 ， 
URL 中 的 /rango/ 部 分 来 自 项 目的 urls py 模块 ， 余 下 的 部 分 则 由 Rango 应 用 的 urls py 模块 负责 。 


调整 注册 流程 


至 此 , 一 切 GEA) 就 绕 了 ， 接 下 来 要 调整 用 户 的 注册 流程 。 前 面 ， 我 们 定义 了 一 个 基于 类 的 视 
图 ， 名 为 MyRegistrationView。 在 那个 类 中 我 们 修改 了 成 功 注册 后 的 重 定向 地 址 ， 转 到 Rango 应 
用 的 首页 。 现 在 ,我们 要 把 重 定向 地 址 改 为 这 个 填写 额外 信息 的 页 面 。 前 一 小 结 把 这 个 页 面 的 
URL 命名 为 register_profile， 因 此 要 像 下 面 这 样 修改 MyRegistrationView 类 。 


class MyRegistrationView(RegistrationView): 
def get_success_url(self, user): 
return reverse('register_profile') 


现在 ， 注 册 账 户 时 ， 先 重 定向 到 这 个 页 面 填写 额外 信息 ， 然 后 再 重 定向 到 Rango 应 用 的 首页 。 


E 基于 类 的 视图 m 


这 一 小 节 提 到 了 "基于 类 的 视图 "。 基 于 类 的 视图 与 基于 函数 的 视图 有 所 不 同 ， 它 更 优雅 ， 但 
是 也 更 复杂 。 本 书 一 直 使 用 基于 函数 的 视图 ， 我 们 在 views py 模块 中 定义 了 一 些 视 图 函数 ， 
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处 理 不 同 的 请 求 。 基 于 类 的 视图 利用 继承 ， 通 过 实现 一 系列 方法 处 理 请 求 。 例 如 ， 在 视图 函 
数 中 我 们 时 常会 判断 是 GET 请 求 还 是 POST 请 求 ， 但 是 在 基于 类 的 视图 中 ， 我 们 要 分 别 实 
现 get() 和 post() 方法 。 如 果 项 目 比 较 复 杂 ， 要 处 理 的 情况 较 多 ， 使 用 基于 类 的 视图 更 合 
适 。 详 情 参 见 Django 文档 。 


</> 附加 练习 


J 阅读 Django 文档 ， 学 习 如 何 编写 基于 类 的 视图 。 
1 把 Rango 应 用 中 的 视图 函数 改 成 基于 类 的 视图 。 
D 在 Twitter 中 发 表 你 的 感受 ， 并 @tangowithdjango, 


B.4 查看 个 人 资料 


有 了 个 人 资料 ， 我 们 还 要 让 用 户 能 查看 和 编辑 自己 的 个 人 资料 。 实 现 的 过 程 也 跟前 面 差不多 。 基 
本 步 又 如 下 : 


J 新 建 一 个 模板 ， 命 名 为 profile html, 
J 编写 一 个 视图 ， 命 名 为 profile()， 泻 染 profile htm 模板 。 
J 把 profile() 视图 映射 到 一 个 URL 上 (/rango/profile) 。 


此 外 ， 还 要 在 Rango 应 用 的 base htm 模板 中 添加 一 个 链接 ， 指 向 这 个 新 视图 。 我 们 将 创建 一 个 通 
用 的 视图 ， 能 查看 任何 用 户 的 信息 。 已 登录 的 用 户 还 可 以 编辑 个 人 资料 ， 但 只 能 编辑 自己 的 。 


创建 模板 


首先 创建 一 个 简单 的 模板 ， 显 示 用 户 的 个 人 资料 。 在 Rango 应 用 的 模板 目录 中 新 建 profile.html 模 
板 文 件 ， 写 入 下 述 HTML 标记 和 Django 模板 代码 。 


{% extends 'rango/base.html' %} 


{% load staticfiles %} 


{% block title %}{{ selecteduser.username }} Profile{% endblock %} 
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{% block body_block %} 


<hi>{{selecteduser.username}} Profile</h1> 
<img src="{{ MEDIA_URL }}{{userprofile.picture }}" 


width="300" 
height="300" 
alt="{{selecteduser.username}}" /> 
<br/> 
<div> 
{% if selecteduser.username == user.username %} 


<form method="post" action=". 
{% csrf_token %} 
{{ form.as_p }} 
<input type="submit" value="Update" /> 


enctype="muLtipart/form-data"> 


</form> 
{% else %} 
<p><strong>Website:</strong> <a href="{{userprofile.website}}"> 
{{userprofile.website}}</a></p> 
{% endif %} 
</div> 
<div id="edit_profile"></div> 
{% endblock %} 


注意 ， 我 们 要 在 模板 上 下 文中 定义 几 个 变量 : selecteduser, userprofile 和 form, 


这 个 模板 的 重点 在 body_block 区 块 中 ， 首 先 显 示 用 户 的 头像 ， 然 后 通过 form 变量 生成 一 个 表 

单 ， 让 用 户 修 改 自 己 的 信息 。 这 个 表单 仅 在 选择 的 用 户 与 当前 登录 的 用 户 一 致 时 才 显 示 ， 也 就 是 
只 让 登录 的 用 户 编辑 自己 的 个 人 资料 。 如 果 选 择 的 用 户 与 当前 登录 的 用 户 不 一 致 ， 那 就 只 显示 用 
户 的 个 人 资料 ， 但 是 不 能 编辑 。 


此 外 请 注意 ， 这 个 表单 也 设 定 了 enctype="multipart/form-data"， 因 为 要 上 传 图 像 。 


编写 视图 


根据 上 述 模板 ， 下 面 编写 一 个 简单 的 视图 ， 处 理 对 用 户 个 人 资料 的 查看 和 表单 数据 的 提交 。 在 
Rango 应 用 的 views py 模块 中 ， 定 义 一 个 名 为 profile() 的 视图 。 


@login_required 


def profile(request, username): 
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try: 
user = User.objects.get(username=username) 
except User .DoesNotExist: 


return redirect('index') 


userprofile = UserProfile.objects.get_or_create(user=user)[0] 
form = UserProfileForm( 
{'website': userprofile.website, 'picture': userprofile.picture}) 


if request.method == 'POST': 
form = UserProfileForm(request.POST, request.FILES, instance=userprofile) 
if form.is_valid(): 
form. save(commit=True) 
return redirect('profile', user.username) 
else: 
print(form.errors) 


return render(request, 'rango/profile.html', 
{'userprofile': userprofile, 'selecteduser': user, 'form': form}) 


这 个 视图 要 求 用 户 已 登录 ， 因 此 我 们 加 上 了 @login_required 装饰 器 。 首 先 ， 从 数据 库 中 查询 指 
定 的 django.contrib.auth.Use 对 象 。 如 果 找 不 到 用 户 ， 重 定向 到 Rango 应 用 的 首页 ， 而 不 显示 
错误 消息 一 一 不 给 不 存在 的 用 户 提 供 任何 信息 。 如 果 用 户 存 在 ， 再 获取 相应 的 UserProfile 实 
例 。 如 果 用 户 还 没 设 定 个 人 资料 ， 可 以 创建 一 个 空 的 UserProfile 对 象 。 随 后 创建 一 个 
UserProfileForm 对 象 ， 使 用 找到 的 用 户 的 个 人 信息 填充 。 这 个 表单 是 否 呈 现 给 用 户 由 模板 控制 。 


接 下 来 判断 是 不 是 HTTP POST 请 求 ， 即 是 不 是 提交 表单 更 新 个 人 资料 。 如 果 是 ， 从 请 求 数据 中 
提取 信息 ， 新 建 一 个 UserProfileForn 实例 。 这 里 我 们 把 instance 参数 设 为 前 面 创建 的 
UserProfile 模型 实例 ， 而 不 每 次 都 新 建 。 注 意 ， 这 是 更 新 ， 而 不 是 新 建 。 如 果 表 单数 据 有 效 ， 保 
存 。 如 果 数 据 无 效 ， 或 者 是 HTTP GET 请 求 ， 泻 染 profile.html 模板 。 


</> 一 道 简单 的 练习 


如 何 修改 上 述 代码 ， 以 免 用 户 修改 别 的 用 户 的 个 人 资料 ?为 此 要 添加 什么 条 件 判断 ? 
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映射 URL 


接 下 来 要 把 profile() 视图 映射 到 一 个 URL 上 。 跟 之 前 一 样 ， 我 们 要 在 Rango 应 用 的 urls py 模 
卖 中 添加 一 行 代码 。 把 下 述 代码 添加 到 urtpatterns 列表 的 末尾 ; 


url(r'“profile/(?P<username>[\w\-]+)/$', views.profile, name='profile'), 


注意 ， 正 则 表达 式 中 有 个 username 变量 ， 它 匹配 /profile/ 之 后 的 内 容 。 例 如 ， 对 URL /rango/pro- 
file/maxwelld90 来 说 ，username 的 值 是 maxweLLd90， 这 也 就 是 传 给 profile() 视图 的 username & 
数 的 值 。 我 们 就 是 这 样 判断 当前 查看 的 是 哪个 用 户 的 个 人 资料 。 


调整 基 模 板 


现在 一 切 应 该 都 能 按 预 期 使 用 了 ， 不 过 最 好 在 Rango 应 用 的 base.html 模板 中 添加 一 个 链接 ， 指 向 
当前 登录 用 户 的 个 人 资料 页 面 ， 方 面 用 户 查 看 和 编辑 自己 的 个 人 资料 。 打 开 Rango 应 用 的 
base.html 模板 ， 找 到 导航 栏 中 为 已 登录 用 户 显 示 的 那些 链接 。 在 其 中 添加 下 述 链 接 : 


<a href="{% url 'profile' user.username %}">Profile</a> 


你 还 可 以 为 这 个 链接 添加 额外 信息 ， 例 如 为 <a> 标签 添加 class 属性 ， 以 便 添加 样式 。 


| © © /WRango- david Profile x | David 


€ Œ | © 127.0.0.1:8000/rango/profile/david/ wenog: 


P david Profile 


Website: http://www.dmax.org.uk 


Picture: Choose File No file chosen 


Update 


图 B-2: 用 户 个 人 资料 页 面 
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B.5 列 出 所 有 用 户 


最 后 一 项 挑战 是 再 创建 一 个 页 面 ， 列 出 Rango 应 用 的 所 有 用 户 。 这 个 任务 不 难 ， 我 们 需要 创建 一 
个 模板 、 编 写 一 个 视图 ， 再 映射 URL。 我 们 需要 获取 在 Rango 应 用 中 注册 的 所 有 用 户 ， 并 为 每 个 
用 户 添 加 一 个 链接 ， 以 便 查 看 他 们 的 个 人 资料 。 


创建 模板 


在 Rango 应 用 的 模板 目录 中 ， 创 建 一 个 名 为 list_profiles.html 的 模板 ， 写 人 下 述 HTML 标记 和 
Django 模板 代码 。 


{% extends 'rango/base_bootstrap.html' %} 
{% load staticfiles %} 
{% block title %}User Profiles{% endblock %} 


{% block body_block %} 
<hi>User Profiles</h1i> 


<div class="panel"> 
{% if userprofile list %} 
<div class="panel-heading"> 
<!-- 按 顺 序 显 示 搜 索 结 果 --> 
<div class="panel-body"> 
<div class="lList-group"> 
{% for listuser in userprofile_list %} 
<div class="List-group-item"> 
<h4 class="List-group-item-heading"> 
<a href="{% url 'profile' listuser.user.username %}"> 
{{ listuser.user.username }}</a> 


</h4> 
</div> 
{% endfor %} 
</div> 
</div> 


</div> 
{% else %} 
<p>There are no users for the site.</p> 
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{% endif %} 
</div> 
{% endblock %} 


这 个 模板 没什么 难 理解 的 ， 我 们 创建 了 一 系列 <div> 标签 ， 并 设 定 了 class 属性 ， 使 用 Bootstrap 
装饰 。 对 找到 的 每 个 用 户 ， 显 示 其 用 户 名 ， 并 提供 一 个 链接 ， 指 向 那个 用 户 的 个 人 资料 页 面 。 注 
意 ， 我 们 迭代 的 是 UserProfile 对 象 列 表 ， 因 此 要 通过 UserProfile 对 象 的 user 属性 获取 


username, 


编写 视图 


接 下 来 要 编写 对 应 的 视图 ， 从 UserProfile 模型 中 检索 全 部 用 户 。 我 们 假定 只 有 已 登录 用 户 才能 
查看 这 个 视图 。 把 下 述 list_profiles() 视图 添加 到 Rango 应 用 的 views.py 模块 中 。 


@login_required 
def list_profiles(request): 
userprofile_list = UserProfile.objects.all() 


return render(request, 'rango/list_profiles.html', 
{'userprofile_list' : userprofile_list}) 


映射 URL， 添 加 链接 


最 后 ， 把 list_profiles() 视图 映射 到 一 个 URL 上。 打开 Rango 应 用 的 urls py 模块 ， 把 下 述 代码 
添加 到 urlpatterns 列表 里 : 


url(r'^profiles/$', views.list_profiles, name='list_profiles'), 


此 外 ， 还 可 以 在 Rango 应 用 的 base html 模板 中 添加 一 个 链接 ， 让 已 登录 用 户 碍 看 这 个 页 面 。 跟 前 
面 一 样 ， 把 下 述 标记 添加 到 只 有 登录 用 户 才能 看 到 的 那些 链接 当中 。 


<a href="{% url 'list_profiles' %}">List Profiles</a> 


添加 这 个 链接 后 ， 你 便 可 以 查看 用 户 列表 和 各 用 户 的 个 人 资料 了 。 
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</> 改进 个 人 资料 页 面 


J] 修改 用 户 列 表 ， 显 示 用 户 的 头像 。 
J 如 果 用 户 没 有 上 传 头 像 ， 显 示 默 认 的 图 片 。 可 以 使 用 LoremPixel 这 种 服务 生成 图 像 。 


* fem x 


可 以 使 用 <img width="64" height="64" src="http://lorempixel.com/64/64/people/"/> 从 


LoremPixel 获取 一 张 64x64 的 头像 。 注 意 ， 可 能 要 等 几 秒 钟 图 片 才能 下 载 好 。 
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